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CP/M-86 is a single user microcomputer operating system 
developed by Digital Research. This thesis provides a 
multi-user "protected'* CP/M-36 based disk sharing 
environment consisting of four Intel iSBC 86/12A single 
board computers, a MBB-80 bubble memory, and the REMEX Data 
inarehouse 3203 memory storage unit. The REMEX houses a 14 
inch Winchester hard diSK and two flexible floppy disi 
drives providing in excess of 23 megabytes of data storage 
capacity. The major objective in the design of this system 
was to create a table-driven CP/M-36 Basic Input/Output 
System that could be quickly and easily reconfigured to 
adapt to any new hardware configuration. Once the system 
was operational, the EEMEX hard diss could then serve as a 
"signal processor" emulation for the AEGIS system. By 
making direct calls to the appropriate read/write routines, 
stored "radar data" could be retrieved from the hard disk 
for use by the other system processes. 
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I. INTRODUCTION 



A. BACKGROUND 

One of the most popular operating systems available for 
microcomputers today is the family of Digital Research's 
CP/M operating systems. They .are single user systems which 
can be configured to interface with nearly any existing 
piece of hardware simply by redesigning the Basic 
Input/Output System (BIOS) module pf CP/M. Since CP/M is a 
single user system, protection from other users is not 
normally an issue of concern with this operating system. 

MP/M, also marketed by Digital Research, Is a multi-user 
operating system wnich supports multiprogramming on a 
uniprocessor. It is basically an expanded version of CP/M. 
However, MP/M provides virtually no protection for user 
files and very little protection for memory in the event 
that another user's process crashes. Furthermore, when more 
than one user is operating under MP/M, system response time 
is noticeably increased. 

B. PURPOSE 

This thesis presents an implementation of CP/M-S6 which 
will permit multiple users, each with his own 
microcomputer, to access the same peripheral devices in a 
manner similar to that of the MP/M operating system, but 
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with increased user protection. The peripherals used in 
this implementation are a 32K common memory board, a M33-60 
magnetic bubble memory configured as a floppy dislc drive, 
and a Remei Eata Warehouse memory storage unit consisting 
of a Winchester hard disk and two flexible floppy disk 
drives. In addition, computer performance is not 
compromised since each user has a dedicated IMTSL S6/12A 
iSBC on which to operate. 

The standard version of CP/M-86 requires that only the 
BIOS be altered to add additional hardware. While this is 
an excellent method to interface hardware with C?/M, it 
requires that the BIOS be rewritten every time the hardware 
configuration is changed. This process can become time 
consuming and is definitely prone to errors, thus 
discouraging frequent system reconfiguration. Therefore, in 
the design ^f this system, a major goal was to develop a 
BIOS which could easily be modified if it was necessary to 
convert from one hardware configuration to another. 

This thesis was based on work accomplished in two 
previous theses. Michael Candelor's thesis entitled 
"Alteration of the C?/M Operating System" [Ref. 1] 
initially modified CP/M-66 to interface with the Intel 1201 
and 1202 Floppy Disk Controllers. Michael Hicklin and 
Jeffery Neufeld, in their thesis "Adaptation of the Magnetic 
Bubble Memory in a Standard Microcomputer Environment", 
[Ref. 2] interfaced the MB3-80 3ubbl-3oard and the 1232 
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Floppy Cisi Controller with the CP/M-86 Operating System. 
Although Hiclclln and Neufeld claimed that their BIOS was 
table-driven, it was Nicjt Hammond who really identified that 
the BIOS functions could be truly table-driven [Ref. 3]. 
This thesis builds on the ideas contained in each of these 
previous works and expands upon them to create a more 
practical and versatile operating system which provides 
increased protection of the user's address space and files. 

Once the system was operational, the RSMEX hard disk 
could then be used to emulate the "signal processor" 
functions of the AEGIS system. Direct calls can be made to 
the appropriate read/write driver routines to retrieve 
stored "radar data" from the hard disk for use by the other 
emulated processes in tne system. 

This thesis has been 'organized into four major sections. 
The first section deals with an overview of CP/f^-66 and the 
necessary steps required to create a new CP/M-86 system. It 
also describes how the BIOS interfaces with the other 
modules of CP/M-86 and the peripheral devices. Included in 
this section is a description of how the BIOS can be 
reconfigured into a table-driven operating system wnlch will 
permit easy alterations to the BIOS if the hardware 
configuration should be modified. 

The second section describes the hardware configuration 
utilized in this thesis. The memory organization of the 
MBB-80 Bubbl-Eoard is discussed and the design decisions 



that were made to make the bubble memory compatible with 
the CP/M operating sytem are treated in some detail. The 
basic functions of the REMEX Data Warehouse are also 
described, as well as, the command packet structure and 
execution . 

The third section is concerned with the development of a 
CP/M-86 operating system which will permit four single board 
computers to operate simultaneously while sharing the same 
peripherals. In this design, it is necessary to provide 
protection to common memory during read and write operations 
and to insure that each user's files are write protected 
with respect to all other uses. 

The final section describes the tests that were 
conducted to evaluate system performance. In addition, the 
feasibility of using the REMEX hard disk to emulate the 
"signal processor" of the AEGIS system was explored. 
Measurements were made using direct calls to low-levei read 
routines to determine the optimum skew factor for 
consecutive sector access operations. Also, some 
recommendations were made for future projects involving the 
REMEX Data Warehouse and the multi-user CP/M-66 operating 
sys tern. 
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n. CP^M-S6 



A. TEE CP/M OPERATING SYSTEM 

CP/M-86 is an operating system developed for use on a 
single INTEL Corporation 66/12A microcomputer. C?/M is 
supplied with a number of built-in utility commands as well 
as transient utilities such as the assembler (ASM66.CMD; and 
the Dynamic Machine Language Program Debugger (DDTS6.CMD). 
These are described in detail in Digital Research 
publications. [Refs. 4-6] 

The CP/M operating system itself is modularized to 
permit easy adaption of CP/M to any hardware configuration. 
The three modules are the Console Command Processor (CCP), 
the Basic Disic Operating System (5D0S) and the user 
configuraole Basic Input/Output System (BIOS). The first 
two modules are supplied by Digital Research as a single hex 
file entitled CPM.H66. This file contains all the code 
necessary for processing commands entered at the 
console and for handling all logical file and disic 
management functions. The source code for a slceleton BIOS 
is also provided which the user can alter to suit his 
individual hardware requirements. Once the BIOS has been 
modified, it is assembled and then concatenated with 
CPM.H86. The resulting hex file, CPMSTS.H66, is converted 
to an executable file by the use of the CP/M utility program 
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1. USER BI0S.A86 ==> ASM86.CMD ==> USER BIOS .H86 

2. CPM,H86 + USER BI0S.E66 ==> PIP.CMD ==> CPMSTS.H66 

3. CPMSTS.H86 ==> GENCMD.CMD ==> CPMSTS.CMD 

(8080 CODELA40]) 

4. CPMSTS.CME ==> PIP.CMD ==> CPM.STS 

(rename on new disk) 

Figure 2.1 

Steps for Creating CPM.STS 

GENCMD.CMD. Finally, this file is renamed CPM.STS and placed 
on a diskette for use. This process is shown in Figure 2.1. 
Details concerning the operation of GENCMD.CMD, LDCOPT.CMD 
and PIP.CMD can be found in the "CP/M-86 Operating System 
Guide". [Ref. 6] 

CP/M-66 supports programs written in three memory 
models: the 8080 Model, the Small Model, and the Compact 

Model. All three memory models are described in detail in 
Reference 5. The model used in this thesis is the 6080 

Model because it supports programs which have code and data 
areas intermixed and which normally have single segments of 
64K bytes or less. 

3. LOADING CP/M-86 

The file CPM.STS is too large to fit onto the first two 
tracks of a normally-formatted diskette. Thus, a boot 
loader must be placed on these tracks and loaded into memory 
by the cold start loader. This boot loader program will 
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then bring the main CP/M operating system into memory and 
pass control to it. 

The loader program is distributed by Digital Research 
in three separate modules and is basically a subset of the 
entire CP/M system. The modules are the Loader Console 
Command Processor (LDCCP.HS6), the Loader Disk Operating 
System (LDBDOS .H86) , and a user configurable Loader Basic 
Input /Output System (LD3I0S.A66'' which is almost identical 
to the system BIOS. The primary differences deal with the 
physical memory location of the loader, the interrupt 
structure and the BIOS offset address within the CP/M 
system. Assembly of the loader BIOS is controlled by a 
conditional assembly switch provided in the skeleton BIOS, 
which is listed in Appendix E of Reference 6. The steps 
needed to obtain a loader BIOS are essentially the same as‘ 
for creating the CPM.SYS. The exact steps are shown in 
Figure 2.2. 

1. USSR LDBI0S.A86 ==> ASM86.CMD ==> USSR LDBIOS .E86 

2. LDCCP.H86 + LDBDOS. HS6 + USER LDBIOS. H86 ==> PIP.CMD 

==> LOADER. H56 

3. LOADER. aee ==> GENCMD.cmd ==> LOADER.CMD 

(8080 CODE[A400]) 

4. LOADER.CMD ==> LDCOPY.CMD ==> LOADER.CMD 

(load on tracks 0 and 1) 

Figure 2.2 

Steps For Creating Boot LOADER.CMD 
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C. BOOTSTRAPPING THE iSBC 86/12A 

From the monitor of the ISBC 86/12A, the CP/M system 
loader program located on tracks 0 and 1 of the disk, can 
be accessed via the bootstrap or cold start loader program. 
This program is located in ROM or EPROM on the iSBC S6/12A 
board itself. Thus, for each separate device from which the 
system is to be booted, a new cold start loader program must 
be written and then burned into ROM. Finally, this ROM must 
be mounted on the iSBC 86/12A board where it can be accessed 
by the monitor program. 

Currently, two cold start loader programs are available 
for the iSBC 86/12A. One allows the system to be booted 
from either the single or double density Intel MDS floppy 
disk drive system by executing the command GFFD4:0 from the 
iSBC 66/12A 957 monitor program. When this command is 
executed, the program in the ROM will go out to tracks 0 and 
1 of the floppy diskette and attempt to bring into memory 
the CP/M system loader program. Once loaded into memory, 
the cold start loader will then transfer control to the 
loader which in turn will locate the CP/M system (CPM.SYS) 
on the disk and load it into memory. Finally, the system 
loader will relinquish control to the CP/M operating system. 
The source code for this bootstrap program is listed in 
Appendix C of Reference 1. 

The second program allows bootloading from tne MBB-ac 
bubble memory device by issuing the command GFFD4:4. 
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Currently this last command can only he used when operating 
on the iSBC 86/12A which is labeled #1, as it is the only 
computer .with an EPROM that contains the cold start loader 
for the bubble memory. The source code for this program, 
which was developed by Hiclclln and Neufeld, can be found in 
Appendix D of Reference 2. 

This thesis uses the bubble memory to initially boot 
the system. Therefore, a new cold start loader program or 
CP/M system loader program did not have to be developed. 
All that is required to change the operating system that 
will be loaded is to place a new CP/M system (CPM.SIS) on 
the bubble memory storage device. 

The loader program placed on tracts 0 and 1 of the 
bubble memory used for loading the CP/M operating system is 
entitled MB80LDR.CMD. This file is created by following the 
steps indicated in Figure 2.2 utilizing MES0BICS .Ac6 as the 
source file with the loader conditional assembly switch set 
to true. 

D. DISK PARAMETER TABLE 

The CP/M-86 operating system as marteted by Digital 
Research is considered a table driven system since all 
characteristics for each I/O device is placed in a table 
called the Disk Parameter Table which can handle up to 
sixteen separate devices. This table defines the logical 
organization of the physical storage media for the BDOS file 
management functions and must be included in every BIOS. 



19 



A disk definition statement is required for each 
physical device and consists of a sequence of words which 
define the characteristics of a device. Figure 2.3 shows 
the format of a disk definition statement. These statements 
are then used to generate the Disk Parameter Table by 
executing the utility program entitled GENDEF.CMD [Ref 6, 
p.72l. The file created by this program must be included in 



DISK DEF: dn, fsc, Isc, [skf] , bis, dir, cks, ofs, [0] 
where 

dn is the logical disk number (0 to 15) 

fsc is the first physical sector number (0 or 1) 

Isc is the last logical 128 byte sector number 

skf is the optional skew factor 

bis is the data allocation blocK size 

dsk is the disk size in bis units 

dir is the number of directory entries 

cks is the number of "checked* directory entries 

ofs is the track offset to logical track 0 

(normally 2 as track 0 and 1 contain the loader) 
[ 0 ] is the optional 1.4 version compatibility flag 

Figure 2.3 

Format of Disk Definition statement 



the BIOS using an "include" statement. The file which 
contains the disk definition statements for this thesis is 
labeled CPMN.AST.DFF and used to generate a Disk Parameter 
Table which is located in the file called CPMMAST.LIB. 
These two files can be found in Appendices G and H. 

To create a disk definition statement for the table, the 
characteristics for the device must be known. This 
information is usually located in the technical manuals for 
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the given device. For example, the disk definition 
statement used for the REMEX Winchester hard disk was: 

DISIDEF 3,1,156,0,16384,255,128,0,1. 

The first ”3” indicates that the hard disk is CP/M's 
logical drive number "3” and can be accessed via the ”D : ” 
command from within CP/M. 

The next two numbers correspond to the first and last 
logical sector numbers for the Winchester hard disk as seen 
by CP/M. The actual physical sectors for the hard disk are 
numbered from 1 to 39, each containing 512 bytes. Since 
CP/M requires the number of logical 126 byte sectors, 39 is 
multiplied by 4 to produce 156 logical sectors of 12S bytes. 
The actual mapping from the logical to the physical sectors 
is accomplished in the blocking and deblocking subroutines 
located in the code for the REMEX hard disk (RXHARD.Ac6) and 
is described in more detail in the Chapter IV. 

The REMEX technical manual does not indicate what the 
most effective skew factor is, thus zero was chosen because 
it was required by the blocking and deblocking routines. 
However, an optimal skew factor may be determined 
experimentally when the REMEX hard disk is used to emulate 
the "signal processor” of the AEGIS system. If so, the 
blocking/deblo eking routine will have to be modified at that 
time . 
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The ”bls” parameter specifies the number of bytes 
allocated to each data block. This number can be 1024, 
2048, 4096, 8192, or 16,384. When larger block sizes are 
used, each directory entry can address more data. This 
reduces the amount of work that the BIOS must do, resulting 
in reduced system response time. Therefore, a block size of 
16,384 was chosen. 

The **dsk” specifies the total disk size in terms of data 
blocks. It is derived by dividing the total byte capacity 
of the disk by the data block size. In this implementation, 
the Winchester disk contains approximately 20 megabytes of 
data storage which is subdivided between four separate 
heads. Thus 4,193,280 bytes are allocated to the "D:” drive 
and this figure is divided by 16,384 to produce 255 data 
blocks . 

The next figure, 128, indicates the number of directory 
entries that are permitted on this drive. 

The "cks” term determines the number of directory items 
to be checKed on each directory scan and is primarily used 
for detecting changed disks during system operations. \s 
the Winchester disk is permanently mounted, a value of zero 
was chosen for this parameter. 

Ihe "’ofs" value determines the number of tracks to be 
skipped when accessing the disk. In essence, it reserves 
tracks for permanent storage. IraczC 3 is reserved since the 
Remex requires it for internal system use and errors .viil 
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occur if an attempt is made to access it. On a floppy disk, 
this value is usually two as tracks 0 and 1 are normally 
reserved for the loader program. 

E. TEE STANDARD BIOS 

The BIOS for CP/M-86 always begins at an offset of 2500 
hex from the beginning of the CP/M-86 operating system. At 
this location are twenty-one entry points used by the CCP 
and the BDOS to gain access to the BIOS functions. These 
entry points form a jump vector to other subroutines in the 
BIOS which contain the necessary code to interface with each 
hardware device. 

There are three types of functions in the BIOS: system 
ini t ial iza tion/reini tal i za t i on , simple character I/O and 
disk I/O. Several of these functions are normally not 
implemented in most microcomputer systems, while others 
require extensive and quite different code implementations 
for each separate device. The BIOS also contains the Disk 
Parameter Tables which represent the physical description of 
the disk drives. Einally, located at the end of the BIOS, 
there is a scratchpad area for certain BDOS operations. 
Figure 2.4 shows the memory map of tne BIOS. 

In order to simply access a diskette, several functions 
located within the BIOS may have to be performed. For 
example, to access the directory of a diskette, the BDOS 
will require the following functions to be performed by the 
BIOS: SELDSK, HOME, SETTRK, SSTSEC, SETDMA , SETDMA3 and 
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CS, DS, ES, SS: 



CONSOLE COMMAND 
PROCESSOR 
& 

BASIC DISK OPERATING 
SYSTEM 



CS + 2500H: ! BIOS JUMP VECTOR 



CS + 253PH: I 

i BIOS SUBROUTINES 



DISK PARAMETER 
TABLES 



UNINITIALIZED 
SCRATCH RAM 



Figure 2.4 

Memory Map of the Standard BIOS 

READ. [Ref. 6: p.60] For each function executed, the BIGS 
will have to determine which physical device is being 
accessed and then Jump to or call the subroutine which 
contains the code for that specific device. For example, 
suppose a simple READ function is required by the BCOS . It 
will initiate a call to the BIOS READ entry point wcich in 
turn will vector the call to the READ subroutine. Here the 
BIOS will determine which physical device corresponds to tne 
CP/M's logical drive and then jump to the appropriate code 
to read data from that specific device. (See Figure 2.5) 

This procedure is very logical and malces it easy for a 
user to implement his specific device dependent 
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CCP 

1 > call to BIOS to Read Device #2 — > 

BDOS ! 

I 

I 

< < 

1 

I 

I BIOS: jmp init 
I jmp write 

> JMP read > 



Jmp wboot 1 

I 

I 

< < 

I 

! init: 

I code for initializing all devices 

I ret 

I 

I 

j write: 

I code for writing to all devices 

1 ret 

I 

> READ: 

determine device 
jmp read_device #1 

JMP RSAD_DEVICE #2 > 

jmp read_device #3 1 

J 

< < 

read_device #1 : 

code for reading device irl 
ret 

> RSAD_DEVICS #2: 

CODE FOR READING DEVICE #2 

RET 

read_derice #3 

code for' reading device #3 
ret 



Figure 2.5 

Path of CCP or BDOS Function 
Call in the Standard BIOS 
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code. However, problems arise if tne hardware configuration 
must be altered. Sverytime the configuration changes, the 
code for each function in the BIOS must be rewritten. This 
can be a time consuming task. In addition, assumptions made 
concerning the implementation of one configuration may lead 
to errors in another configuration should those assumptions 
no longer be valid. These errors may also be extremely 
difficult to locate and correct since all code is usually 
intermixed and the exact order that the CCP and 3D0S call 
various functions in the BIOS is not known to the user. 

r. BIOS ALTERATION 

Hicklin and Neufeld attempted to develop a table driven 
BIOS. In a manner of speaking they succeeded. However, the 
only devices that are permitted in their device table are 
additional Intel MBS double density disk drive systems and 
MBB-80 bubble memory storage devices. Attempting to 
integrate another device such as the RIME! Data Warehouse, 
leads to the same problems which were mentioned earlier. 

To alleviate these problems, a completely table-driven 
BIOS was developed in which only minor and straight-forward 
changes would have to be made in order to change hardware 
configurations. This was accomplished by extracting out all 
the device-dependent functions of the BIOS into separate 
files for each unique device. Specifically, these functions 
were INIT, SELDSK, HOME, SELTRK, SELSEC, READ, and WRITE. 
Functions such as WBOOT are not dependent upon a particular 
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device and do not have to-be extracted, while functions such 
as PUNCH and RSAUER are not implemented. 

In the hardware configuration for this thesis, three 
separate files were required. These were M3S0DSS.A86, 
RXFL0P.A86, RXEARD.A86. These files each contain the 
necessary code to execute the seven device-specific 
functions for the MBB-80 bubble storage device, the Remex 



CS , DS, SS, SS: 
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BASIC DISK OPERATINO 
SYSTEM 



BIOS JUMP VECTOR 
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INCLUDE LABEL TABLES 
INCLUDE DEVICE 
INCLUDE DEVICE #2 
INCLUDE DEVICE #3 



INCLUDE DEVICE #16 



DISK PARAMETER 
TABLES 



UNINITIALIZED 
SCRATCH RAM 



Figure 2.6 

Memory Map of the Table-Driven BIOS 
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floppy disic drives, and the Remei hard disk, respectively. 
An additional file, CPMMAST.CTG, is also now required. It 
contains tables of labels which correspond to the physical 
memory location of the seven functions for each device used 
in a given hardware configuration. The label tables used in 
this thesis can be found in Appendix C. Figure 2.6 shows 
the memory map of the table driven BIOS. In the BIOS, the 
assembly language instruction "include" is used to 
incorporate the label tables and device-specific code for 
the seven functions into the system. 

For example, when a call is made to read Device #2 from 
the CCP or the BDOS , the call is vectored as was done before 
through the jump vector to the READ subroutine of the BIOS. 
However, after determining the physical device to be 
accessed, instead of jumping directly to the desired code, a 
call is now made to the device specific code located in the 
included device's AS6 file via the Read Table which is 
located in the file CPMMA3T.CFG. The final address of the 
call is determined by the offset of device number into the 
Read-Table, which provides the label or 16-bit address of 
the actual code needed for reading Device #2. (See Figure 
2.7 } 

To alter the hardware configuration, only one line in 
the BIOS must now be changed for each device, that being the 
corresponding "include" statement. The other changes which 
are required, are located in the label tables and the Disk 
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CCP & BDOS > call to BIOS to Read Device #2 --> 

I 

1 

< < 

I 

I B lOS : jmp ini t 
I jmp wri te 

> JMP READ > 

I 

• I 

Jmp wPoot I 

1 

I 

< < 

1 init: 

1 call to init label table 

\ ret 

1 wri te ; 

I call to write laoel table 

1 re t 

> READ; 

determine device 

CALL READ_TABLE [offset device #2] > 

ret I 

< < < L 

! INCLUDE LABEL TABLE 

I ini t_table ; 

j labels 

i write table: 

1 labels 

1 RSAD_TABLE: 

1 read_device #1 

> READ_DZVICE #2 > 

read_device #3 I 

I 

1 

< < 

1 include device #1 

i code for seven device specific functions 

I 

1 INCLUDE DEVICE #2 

1 init_device 

I code for initializing Device #2 

! write_device #2 

1 code for writing to Device 42 

> READ_DEVICE #2 

CODS SOR READING DEVICE #2 



Figure 2.7 

Path of CC? or BDOS Function 
Call in Table-Driven BIOS 
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Parameter Tables. For each device included in the BIOS, 
there must be a corresponding label for an abstracted 
function. These labels must be correctly ordered and 
properly identified. Naturally, when hardware is 
implemented into the system for the first time, the initial 
code for performing the seven device-specific functions must 
be written. But once written, the new device can be added 
or deleted from the operating system with very little 
effort. The fact that all code for each device is completely 
independent of other devices, aids in detecting, locating 
and correcting errors. Actual experience has shown that 
once the code for a device has been written, going from one 
hardware configuration to another can be accomplished in 
under twenty minutes. 
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III. HARDWARE 



A. GENERAL HARDWARE CONFIGURATION 

The hardware configuration utilized in this thesis 
consists of four -iS3C 86/12A Single Board Computers, a MBB- 
60 Buhhl-Board, a 32K byte common memory board, and the 
RSl^EI Data Warehouse memory storage device with Multibus 
Interface Card Assembly. The components are all Multibus 
compatible and were placed in an iCS-80 Industrial Chassis 
for system operation. Figure 3.1 depicts the physical 
hardware configuration. Table 3.1 describes the logical-to- 
physical mapping between the CP/M representation of the 
system and the actual physical hardware. 



1 32S COMMON | 1 BUBBLE | ! REMEI 1 

I MEMORY ! ! MEMORY | INTERFACE I ====== 

I I 
I I 



MULTI- BUS 



II II II II 

II II II II 



I iSCB ! 1 iSCB ! 1 iSCB 1 1 iSCB 

I 86/12A ! I 86/12A 1 | 86/12A 86/12A 



Figure 3.1 

Physical Hardware Configuration 
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Table 3.1 

Logical Hardware Configuration 



CP/M's Logical 
Device Number 


1 

1 

1 

1 


Actual 

Drive 


Actual 

Physical Device 


0 


1 

1 

1 


A : 


MBB-60 


i Bubble Memory 


1 


1 

1 

1 

1 


B : 


Remex 


Floppy DisJc Drive 


2 


1 

» 

1 

1 


C : 


Remez 


Floppy Disic Drive 


3 


1 

1 

1 

1 . 


D: 


Remex 


Hard Disk Head 0 


4 


1 

1 

1 

— 1 - 


E: 


Remex 


Hard Disk Head 1 


5 


1 

1 

1 

1 


F; 


Rem ex 


Hard Disk Head 2 


6 


1 

1 

1 


G : 


Remex 


Hard Disk Head 3 



B. INTEL 86/12A SINGLE BOARD COMPUTER 

The Intel iSBC 86/12A Single Board Computer is a complete 
computer system constructed entirely on a single Multibus- 
compatible circuit board. It is designed to operate as a 
standalone system, a bus master in a single bus master 
system, or a bus master in a multiple bus master system. 

The board itself contains an Intel 5066 16-bit 

microprocessor, 64K bytes of dynamic RAM memory, 16K bytes 
of EPROM memory, both serial and parallel I/O ports, a 
programmable timer and interrupt controller, and a Multibus 
interface controller. 

Onboard RAM memory is located between 0 and Offffh and 

the EPROM between F7C00h and FFEEEh within the 1-Megabyte 

address space available to the Intel 6066 microprocessor. 
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If the local processor attempts to address memory outside of 
these ranges, a Multibus access will result. The onboard 
RAM is dual-ported, and therefore is accessible to the local 
processor via an internal bus, as well as, to any external 
Multibus master via the Multibus. In this latter case, the 
onboard RAM is operating in the RAM-Slave mode. Any 
collisions that result when the RAM is simultaneously 
accessed by the local CPU and the Multibus are resolved by 
hardware in favor of the local CPU. 



Vhile 


the location of 


RAM 


rel a tive 


t 0 


the local 


processor 


is fixed between 0 


and 


FFFFh, it 


can 


be switch- 


and- jumper configured into 


any 


12SK segment 


of the 


1- 


Megabyte 


address space relative 


to the 


Multibus . 


In 


addition , 


none or all of the 


onboard RAM, 


in 


segments 


0 f 


16K, may 


be reserved strictly 


for 


local CPU 


use 


. Since 


th e 



major objective of this implementation was to produce a 
CP/M-based multicomputer system in which each computer 
operates totally independently of the others, each iSSC 
36/12A was configured to make all of the onboard RAM 
inaccesible to the Multibus. 

C. MB3-80 3U33L3 MEMORY STORAGE DEVICE 
!• general Description 

The M3B-80 3ubbl-3oard is a complete bubble memory 
storage device designed to be compatible with all S- and 16- 
bit microcomputers that utilize Intel's Multibus 
architecture. The board consists of eight (8) TI30203 
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bu^)'ble devices and the necessary control, buffering, and 
Multibus interface logic. The host CPU interfaces with the 
MBB-60 controller via memory-mapped I/O utilizing any 
sixteen (16) consecutive user-defined addresses within the 
1-Megabyte system address space. These sixteen (16) 
addresses correspond to the sixteen (16) registers in the 
bubble memory controller that are utilized in support of the 
following controller primitive commands: 



Fill Buffer 
Empty Buffer 
Write Single Page 
Read Single Page 
Write Multiple Pages 



Read Multiple Pages 
Ini tialize 
Read Status 

Enabl e/Bi sable Interupts 
Reset 



2. Read /Write Logic 

Read and write operations with the MB3-85) are 
accomplished by specifying a particular bubble device number 
and page number (18 bytes) to read from or write to. The 
MBB-60 controller provides the ability to read or write in 
either a single- or multiple-page mode by using a byte-by- 
byte transfer into a FIFO buffer located on the MBB-80 board 
itself. The single-page mode can be implemented in a 
straight-foward manner without the need for addtional 
supporting hardware or software. However, the multiple-page 
mode requires that certain timing requirements must be 
adhered to by the host CPU when communicating with the MBB- 
60 controller. During a data transfer, the host must 
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respond to interrupts generated by the MBB-60 every 160 
microseconds which signal the completed transfer of one byte 
of Information in a multi-byte transfer. These interrupts 
can be generated on the Multibus and handled by the 
Programmable Interupt Controller (PIC), or the host CPU can 
poll the controller interrupt register (offset 0fh) to 
determine if an interrupt has occurred. The single- and 
multi-page polled modes were implemented by Hiciclin and 
Neufeld [Ref. 2]. The final version of their system 
utilized the multi-page polled mode and tnis was 

subsequently employed in this implementation. 

3- CP/M-36 Compatibility 

In order to effect a data transfer, the MBB-80 
controller must be given a device and initial page number to 
locate the position where the data will be read from or 
written to. On the other hand, CP/M uses a tracic and sector 
number to access data during a disk access. Therefore, a 
mapping must be made from the CP/M tracK and sector number 
to MBB-80 device and page numbers if the CP/M operating 
system is going to be used to access data on the MBB-80 
Bubbl-Board. Hicklin and Neufeld [Ref. 2] decided to use 
the bubble page number as the smallest addressable unit for 
each data transfer and the basis for the MEB-e0 memory 
organization. Since each physical bubble page is eighteen 
(18) bytes long, a logical CP/M sector of 126 bytes consists 
of eight (8) bubble pages of which the last sixteen (16; 



35 



bytes on the last page are not used (i.e. wasted). 
Therefore, the 640 bubble pages per device are mapped- into 
80 logical CP/M sectors per device. Futhermore , it was 
decided that each MBB-80 "trade" would consist of 26 sectors 
which corresponds to the number of sectors per trade on a 
normally-formatted single-density floppy disk. Another 
design decision was that all MBB-80 tracics would be 
co-npletely contained on a single bubble device. Since there 
are 26 CP/M sectors per track and 80 sectors per bubble 
device, this results in three (3) tracks per bubble device 
with two (2) sectors not used or wasted on each device. 

Therefore, based on these design decisions, tne total 

0 

capacity of the MBB-30 Bubbl-Board is 76K bytes on 24 tracks 
(S devices x 3 tracks per device) with a total of 14k bytes 
wasted. Eicklin and Neufeld's final memory organization for 
the MBB-80 is shown in Figure 3.2. Dispite its 

inefficiency, this configuration was adopted for this 
implementation since the principal function of the bubble 
memory is to provide a convenient method of booting CP/M-86 
on our master iSBC 86/12A. Hammond [Ref. 3] has shown that 
there is a more efficient way to organize the MBB-80 in his 
work on utilizing the MB3-80 as a snared resource in a 
multi-microcomputer system. However, this would have 
necessitated the design and implementation of a new 

bootstrap loader program to be placed in the iSBC S6/12A 
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SPROM and was not judged to be of si,enificant importance for 
this implementation. 
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Figure 3.2 

MBB-S0 Logical Storage Organization 
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D. R2MEX DATA WAREHOUSE 

1 • general Description 

The REMEX Data Warehouse is a mass storage memory 
unit containing a fixed Winchester disk drive, two (2) 

flexible diskette drives (single- or double-sided), and a 
microprocessor controller that services all drives. The 
memory capacity of the fixed disk is approximately 20 

megabytes and the flexible diskettes can be formatted to 
contain up to two (2) megabytes of storage. IBM standard EM 
encoding is used for the single density floppy diskette 
while MEM encoding is utilized for the double density 
diskette and the hard disk. 

The fixed disk'is a 14 inch enclosed disk utilizing 
Winchester technology and is composed of two recording 
surfaces. Each surface has two (2) recording heads which 

can each access a total of 213 tracks. Each track can 

contain up to 24K bytes of information. However, only 210 
tracks can be referenced for normal read/write operations. 
The hard disk sector size is switch-selectable to either 
128, 256, 512, or 1024 bytes per sector. The total storage 

capacity for the various sector sizes is shown in Table 
3.2. In addition, the floppy diskette controllers are also 
switch-selectable to handle either single or double density 
diskettes. It is extremely important that these switch 
correspond exactly to the actual format of the hard 
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Table 3.2 

REMEI Hard Disk Sector Selections 



Sector Size 



Sec to rs/Track 



Capacity 



128 

256 



104 

67 



10. 7M bytes 
14. 4M bytes 



512 

1024 



39 

21 



16. 8M bytes 
IS.IM bytes 



§isk and diskette for the read/write operations to function 
correct ly. 

The REMSX Data Warehouse (RDW) is designed to 
transfer all data and co.Timand structures to and from the 
host computer via direct memory access (DMA). To initiate a 
RDW operation, the host computer builds a command packet 
within its local memory. This packet contains all the 
information necessary to effect an RDW operation. The host 
then sends the address of the command packet to the RDW via 
an interface board utilizing programmed I/O. When the RDW 
is ready to accept packets, it inputs the command packet via 
DMA, performs the required function, and transfers any data 
via DMA. When the function is complete, the RDW indicates 
this by noting it in the command packet status word or by 
generating an interrupt on the Multibus. Packets can be 
queued in the RDW up to a maximum of eight. 

Some other important features of the RDW include: 

— Dynamic data buffering (25 i 16 bit buffer) 
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allows a continuous transfer under varying CPU 
conditions . 



— Dynamic ljuffer protects against data overrun and 
underrun preventing loss of data without host 
computer intervention. 



Allows data 


transfers in 


large blocks of up 
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required 
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command packet. 

— Permits chaining packets together in 
noncontiauous memory. 

9 

— Ability to format entire disk with a single 
command . 

— Automatic verification and assignment of 

alternate tracks to cover bad tracks. 

2. Command Packet Organization 

The basic structure of the command packet is shown 
in Figure 3.3. Word 0 is composed of a modifiers section, a 



function 


code block , and 


a logical 




uni t 


section . 


The 


function 


code block specifies whi 


ch 


of 


the six 


(6) 


particular 


REMEX functions 


is to 




perf 


ormed . 
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functions 


are Read, Write 


, Write I 
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and 


Rec ord , 


Copy, 



Format, and Maintenance. 
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Bit Number 



15 8 7 4 3 0 

word 0 ! Modifiers i Function | Logical Unit | 

1 I Status Word I 

2 ! ! 

3 I } 

4 I ! 



N 



A program in the RDW interprets the function number 
and determines how many words are required for each specific 
command packet. The modifiers section contains information 
on packet chaining, program control interrupts, disabling of 
error routines and an "end” marker which specifies a single 
packet or the last packet in a packet string. The logical 
unit can be either 0, 1, or 2. A zero always corresponds to 
the hard disk. However, the floppy diskette drive can be 
operator-configured to respond to either logical unit number 
1 or 2, This is accomplished by the Eevlce Logical Unit 
Switch located on the front panel of the HDW . 

The status word is divided into the least 
significant bits (0-7) and the most significant bits (S-15). 
Each of the least significant bits, when set to (1 ) , 



Modifiers 



I Function 
Status Word 



Logical Unit 



Last Word 



Figure 3.3 

Command Packet Description 
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Table 3.3 
HEMEI Error Codes 



1 

! 


Bit No. 1 




Description 


I 


1 

1 


0 ! 




Normal- Completion 


i 


1 

1 


1 1 




Not Assigned 


1 

1 


1 

1 


2 i 




Controller Error 


1 

1 


1 

\ 


3 i 




Drive Error 


1 

1 


\ 

1 


4 i 




CRC Error 


1 

1 


1 

1 


5 1 




Illegal Packet 


1 

1 


1 

1 


6 1 




Bad Track During Format 


t 

i 


1 

1 


7 I 




Not Assigned 


\ 

\ 



represents a particular status which is indicated in Table 
3.-3 Bits 3- 15 represent the hex code that corresponds to 
the error definitions given in Table' 3-6 of Reference 7. 

Words 2 through N are function dependent and the 
number of words per command packet varies widely between RDW 
operations. In the version of CP/M developed in this thesis, 
only the Read/Write function are implemented and are used to 
access and transfer data. However, additional utility 
programs were written which utilize the other functions to 
format the hard disk (RXEORMA.T .CMC) and to execute the 
built-in maintenance programs (RIMAINT.CMD) of the RDW. 

The format of the Read/Write packet is shown in 
Figure 3.4. The description of these two operations is 
identical except that in a read operation a one (.1; is 
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Bit Number 
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Figure 3.4 

REMEX Read/Write Packet 



placed in the function code block of packet word d and for 
a write operation a two (2) is used. Both operations are 
permitted in blocks of up to 64K words. Any head switching 
or advancing which may be required is automatically 
performed by the RDW disk controller. 

RDV track numbers are assigned from 1 to 210 for 
normal data transfer operations. Track 0 is always reserved 
for a loader or system program and can not be addressed 
during a normal read or write operation without generating 
an error. Presently, the hard disk is formatted for 512 
bytes per sector which corresponds to 39 sectors per track. 
Head numbers for the four RDW heads run from 2 through 3. 
Data addresses are a 24-bit representation of the 20-bit 
address structure supported by the iSBC 86/12A and Multibus 
architecture. The transfer word count is the number of 15- 
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bit words that are to be transferred. For accessing the 
hard dislc, a transfer word count of 100h was placed in the 
packet built by CP/M. This figure corresponds to a single 
sector (512 bytes) or 256 16-bit words on the hard disk, 
which is equivalent to the CP/M-86 Operating System view of 
512 8-bit words. 

3. Multijbus Interface Card Assembly 

The command packets are sent to the RL* via a 
Multibus Interface Card Assembly. The interface contains 
ail ‘the necessary buffers, registers and control logic 
required for the transfer of data, status, addresses and 
commands between the REMEX Data Warehouse and the iS3C 
86/12A Single Board Computer. Tne interface operates in both 
a programmed I/O mode and a DMA mode. All data, status, and 
commands are transferred by DMA, while pacKet addresses and 
the interface Command/Status information are transferred via 
programmed I/O. During these transfers, the Multibus 
Interface acts as a bus master in the DMA mode and as a bus 
slave in the programmed I/O mode fRef. 8]. Registers are 
provided for data, packet address holding, and DMA 
addresses. A DMA address counter (20 bits) allows memory 
addressing of up to 1-Megabyte. Control logic for DMA, bus 
timing, interrupt control and device address selection is 
also provided. Selection switches are available to alter 
the interface base address, interrupt priority level, and the 
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DMA throttle which governs how long the interface must wait 
"between DMA transfers. 

In the programmed I/O mode of operation, the 
Multibus Inteface responds only to I/O port addresses. 



Swi tches, 
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mentioned 


above 
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set 


the 


base 


int erface 


port 


address . 
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standard addr 


esses 
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Regi ster 
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port 


address 


070 
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leas t 



significant byte) and port address 071 (most significant 
byte). The standard addresses for tne ?acKet/DMA Register 
are port addreses 072 and 073. A more thorough description 
of the contents of these registers is given in Table 3-2 of 
Reference 7. 

The DMA Throttle Select is used to select the number 
of Multibus accesses that must be completed between 
consecutive DMA transfers by the Multibus Interface. A 
selectable range of 0-15 transfers is provided. The standard 
is 1 host Multibus cycle between interface DMA cycles. This 
is contrary to the explanation given in Section 2.3.3 of 
Reference 7. In this section, the DMA throttle is presented 
in terms of "number of processor cyles” instead of Multibus 
accesses. 

4. Command Packet Execution 

To execute an operation contained in a command 
paclcet, the host computer must first test the Packet Address 
Ready Flag (port 070) which indicates whether the RDW is 
ready to accept and process command packets. If this flag 
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is set (1), the host loads the extended address bits (bits 
17-20) of the command packet into the Command/Status 
Register (port 070). Then the least significant byte 
followed by the most significant byte of the 16-bit address 
of the command packet must be loaded into tne Packet/DMA 
Register (ports 072 and 073 respectively). This sequence 
must be followed exactly because once the most significant 
byte is loaded into port 073, the interface board signals 
the RDV that the address is complete and ready to be 
trans f err ed. 

Upon receiving this signal, the RDW will read the 
address which was placed in the ports of the interface 
board, fetch the command packet located at that address, and 
perform the operation specified in the function code blocs 
of the packet. When the operation is complete, an entry is 
made into the command packet status word (word 0) indicating 
the success or failure of the operation. 

E. ICS-60 INDUSTRIAL CHASSIS 

The iCS-80 Industrial Chassis consists of four (4) four- 
slot iSBC 504/614 Cardcages, four fans, a power supply, a 
control panel and a 19" RETINA (Radio-Slectronics-Television 
Manufacturers Association) -compatible chassis. The control 
panel consists of an on/off/lock key switch, interrupt and 
reset pushbuttons, and halt/pwr on/run LED's. 

The development system was designed to support a modular 
microcomputer- based system. Any combination of plug-in 
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modules which are Multibus-compatible may be installed 
including single board computers, memory eipansion boards 
and peripheral interface boards. The iSBC 604 Cardcage can 
accomodate four (4) iS3C circuit boards and has an external 
plug which allows additional iSBC 614 Cardcages to be added 
to the chassis. The laboratory system used in support of 
this thesis is composed of a single iSBC 604 Cardcage and 
three (3) iSBC 614 Cardcages which allow a total of 16 
circuit board slots. These cardcages comprise a backplane 
assembly that conforms to the Intel Multibus specifications 
and provides slots for both Mutibus master and slave boards. 
The master slots are odd-numbered and the slave positions 
are even-numbered for easy reference. 

A master board is one which is capable of acquiring and 
controlling the Multibus, while a slave board can only be 
referenced by commands on the Multibus (i.e. memory 
expansion boards). The iCS-60 Chassis can be used with 
master boards operating in either a serial or parallel 
priority resolution scheme. In the serial mode, Multibus 
access contention is resolved by the board placement within 
the cardcage. However, an external priority resolver 
network is required to implement the parallel priority 
scheme. In this implementation, a random priority network is 
used to arbitrate the contentions for the Multibus. Most 
importantly, one of tne above priority resolution schemes 
must be implemented or the interaction among the iS3C boards 
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in the cardcages will not be correct. For 
information consult References 9, 13, and 11. 



further 
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IV.SISTgM DEVELOPMENT 



A. INITIAL EFFORTS 

1 • ?iogl§0 Development S:fs tern 

During the initial stages of this thesis, it was 
planned to expand the work done by Hicklin and Neufeld [Ref. 
2] to incorporate the REMSX Data Warehouse nemory storage 
unit. They had developed a reconf igurable "table-driven” 
C?/M-e6 BIOS that supported the MBB-80 Bubbl-Board and the 
Intel 1202 double-density floppy disk controller. It was 
Initially believed that other I/O peripheral devices could 
be easily included in this BIOS with a minimum of effort. 
Within the proposed development system, the MB3-90 would 
serve as the principal storage medium for newly designed 
programs and would provide an easy method of booting EiciClin 
and Neufeld's CPM.STS within the iCS-80 chassis. 

However, this development strategy had several 
deficiencies. Utilizing this hardware/operating system 
configuration, program development would be limited to the 
MDS or iCS-60 systems and the CPM-86 utility programs which 
they supported. Presently, the only compatible text editor 
available is the text editor distributed by Digital 
Research, ED.CMD. This editor is very primitive, extremely 
hard to use, and completely unsatisfactory for extensive 
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program development. Therefore, an alternative development 
system was required. 

It was decided to use the WORDSTAR text editor on 
the MP/M Multi-user System to create the needed software 
programs. This system provided several advantages over the 
MDS system. First, WORDSTAR offers functions which would 
significantly increase productivity and allow errors to he 
quickly corrected. Second, M?/M-compa ti ole versions of ASM- 
£6 and GFNCMD utilities would enable programs to be written, 
assembled, corrected, and converted into executable OMD 
files prior to their transfer to the bubble memory. Third, 
since the MP/M system is a multi-user system, it did not 
present the availability problems associated with the 
single-user systems such as MDS. 

Ultimately, this software development scheme also 
proved to be unsatisfactory, as numerous steps had to be 
taken to move an assembled program from the MP/M system to 
the MBB-S0 board. Since only MP/M and MDS single density 
diskettes were compatible, assembled programs first had to 
be transferred from the MDS single density system to the MDS 
double density system using the laboratory utility program 
SDXFSR.COM. This required that the MDS double density system 
be configured with an Intel £060 processor. Once the 
program was transferred to a double density dissette, the 
MDS double density system had to be reconfigured for use 
with the MBB-S0 bubble board and an iSBC S6/12A. After 
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reconfiguring, the program could now he transferred from the 
double density diskette to the bubble memory. At this point 
the MBB-80 was physically moved to the iCS-80 chassis. 
Finally, the operating system could be loaded and the 
program executed under DDT66. 

Besides being time consuming, the above process 
monopolized much of the laboratory's equipment. Thus, if 
the equipment needed to make the transfer was in use, 
program testing could not be carried out. However, 
initially, it was the only method available and therefore 
had to be employed. 

2* IfrilZ Operation 

The objective of this section was to verify the 
proper operation of the CPM.SIS developed by Eicklin and 
Neufeld. The double density MBS system was configured with a 
single iSBC S6/12A (#1), the MBB-SC bubble memory, and the 
i202 Floppy Disk Controller. The system was successfully 
booted from the 957 Monitor in accordance with the 
procedures given in Reference 11 by executing the command 
GFFD4:0. However, the bubble memory could not be accessed 
using any of the CP/M built-in commands. After inspection 
of the BIOS, it was evident that the final version of the 
CP/M-86 BIOS submitted did not support the MBB-80. 
Therefore, the CPM.STS had to be reconstructed. 

The files DKPBM.DEF and CONFIG. DZF were first 



checked to ensure that the desired hardware configuration 



was accurately reflected in the Disk Definition Tables, the 
Disk Tables, and the Bubble Tables. Once this was completed, 
the file MBBI0S.A66 was reassembled and was then 
concatenated with CPM.H86 using PIP.COM. The resulting hex 
file was then converted to an executable CMD file and 
renamed CPM.STS. 

To ensure that all possible errors were avoided 
prior to system initialization, it was decided to reformat 
the MPB-60. The program MBc3PMT.CMD was executed, inserting 
3030h as the M3B-80 controller base address. Once 
formatted, the CP/M loader program MB80LDR.CMD was placed on 
tracks 0 and 1 of the MEB-80 utilizing tne LDCOPY.CMD 
utility. The reconstructed system was booted and functioned 
normally . 

3. Modification of the BIOS for Use in the iCSrS0 

As envisioned in the program development process, 
new programs would be transferred to the MDS double density 
system using a laboratory utility program. These programs 
could then be placed on the MBE-S0. The MBE-80 would then 
have to be physically moved to the iCS-60 chassis. By 
entering the command GFPD4:4, CP/M-S6 could be booted and 
the programs executed under CP/M or DDT36.CMD. However, 
since the MB3-S0 would be the sole memory storage device in 
the iCS-80 chassis, a new modified BIOS had to be 
construct ed. 
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The changes that needed to be made were located in 
two major areas of the BIOS. First, the file DKPRM.DSF which 
contained the disk definition statements for each logical 
CP/M disk drive had to changed. The number of logical 
devices was changed to 1 and the disk definition statement 
for the MBB-60 was entered as CP/M logical drive 0 (Drive 
A:) indicating that the MBE-SO was the only ’’drive'’ in the 
system. The other changes were made to the Disk and Bubble 
Tables contained in the file CONFIG. DIF. Eicilin and 
Neufeld had created these tables to identify whether C?/M 
logical drive numbers where either MBB-30 devices or i202 
controllers. These tables would support any hardware 

configuration of MBB-60's and i202 contollers up a total of 
16 disk drives (maximum for CP/M). However, other peripheral 
devices such as the REMEI Data Warehouse could not be 
supported as was initially believed. 

Once these changes had been made, the BIOS was 
reassembled and used to create a new CPM.SYS which was 
placed on the bubble memory. It was subsequently tested and 
it functioned normally. 

4. HEMEI Dow^Lgyel Houtines 

Concurrently with the work on the M3B-30, low-level 
read/write routines were written and executed which accessed 
the RFMEX Data Warehouse memory storage unit. This work was 
accomplished on the iCS-80 chassis using an iSBC 86/12A 
single board computer and the REMHX Multibus Interface Card 



Assembly. At first only the most primitive operations were 
performed, since there was no permanent memory in the 
system. Using the 957 Monitor program, small programs were 
executed to examine the various values contained in the 
interface status registers. Once the new MBB-60 CPM.SY3 was 
available, more comprehensive programs were written which 
could build command packets, transmit command packet 
addresses to the interface board, and chec.-c the packet 
status word for function completion. The basic logic of the 
read/write functions was discussed in greater detail in 
Chapter 3 and the logic diagram is snown in Figure 4.1. 

A command packet was built which would write a very 
simple set of characters to a particular head, track, and 
sector number of the RSMEX hard disk or a track and sector 
number on the floppy diskette. Using DDTS6.CMI), the commana 
packet was then altered to produce a read operation which 
would retrieve the previous message from the RDW and write 
it to a selected memory address. EDT66.CME was also 
extensively used to monitor packet construction and memory 
content. With each successful transfer, larger blocks of 
data were transferred until it was concluded that the 
operations were being correctly performed. Although some 
progress was made, the program turn-around tim.e resulting 
from the lack of an adequate development system definitely 
impeded further progress. 



> 



No 



Start 

I 

I 



Check Packet 
Ready Fla^ 



I 

I 

/\ 

/Is\ 

/ it \ 



\set?/ 

\ / 

\/ 

i Tes 

I 

! Build Packet 

I 

I ” 



I 

I 

I 

I Send Packet 

I 



1 

i 

I 

I 



Check Status Word 



I \ 



/\ 

/ I s \ Yes 

/ it \ 

\ = 0 ?/ 

\ / 

\/ 

! No 

/\ 

/Is\ No 

/ it \ > Error 

\ 01 ?/ 

\ / 

\/ 

1 Yes 

I 

I 



Operation Complete 



Figure •4.1 

RDW Read/Write Logic 
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5. TablerBriven 2I0§ 

The development mechanism that had been used up to 
this point was tedious and t ime-com sumi ng . The time 
required to repair errors discovered while working on the 
iCS-80 was too excessive to support cohesive program 
modification. It also became evident that the concepts used 
by Hicklin and Neufeld in the development of their BIOS were 
not sufficient to meet the objectives of this thesis. 
Although it was presented as a model for a very flexible 
system, the BIOS actually only supported M33-6C bubble 
memories and i202 floppy diskette controllers. Inclusion of 
additional peripheral devices would have required major 
modification to the BIOS. Furthermore, even if these 
modifications were made, each time a device was added or 
deleted from the system, the code within the BIOS for the 
individual function calls would have had to be changed. The 
many inconveniences of the program development procedure 
coupled with the limitations of the Kicklin and Meufeld 
approach in a varying hardware environment necessitated a 
new BIOS design strategy. 

Hammond [Ref. 3] had identified that certain device 
specific code could be extracted from the "core” of the BIOS 
without affecting function operation. This was accomplished 
by indirectly vectoring BIOS calls to the proper subroutines 
via a table of labels. Hammond had extracted the READ, 
WRITE, and INIT BIOS functions and constructed the 
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appropriate tables in a separate file named CONFIG. DEF. 
This file was then assembled with the BIOS by means of an 
"include" statement. 

Next, let us examine the SEAL function in greater 
detail to see exactly how this BIOS works. Figure 4.2 
contains the code for the READ function in the "core” BIOS 
for a hardware configuration consisting of an i2Cl Floppy 
Disk Controller. 



read : 

xor bx,bx 
mo7 bl,unit 
add bi,bx 
call readtbl [bi] 
ret 

Figure 4.2 

Table-Driven BIOS Read Code 

This controller supports two floppy dis-^ drives 
which correspond to C?/M logical drives O and 1. This 
correspondence is set up in the Disk Definition Tables. Also 
prior to the 3DOS call to the BIOS HEAD function, the 
desired drive number has been stored in a BIOS variable 
called "unit". The value of "unit" is first placed in the 
"bl " register. Next, it is doubled since each label in the 
read_table represents the 16-bit address of the device- 
specific read functions. A call is now made to the 
read_table using the offset contained in the "bx" register. 
This table entry then indirectly addresses tne appropriate 
subroutine for the desired "unit”. For example, if CP/M 
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read call is 



logical drive 1 (3:) is selected, the 

indirectly addressed to the subroutine label located at an 
offset of two (2) in the read_table. The read_table is 
shown in Figure 4.3. Notice that since both CP/M logical 
drives are floppy disk drives, the read call is vectored to 
the same subroutine. 

readtbl dw offset i201_read 
dw offset i201_read 

Figure 4.3 
BIOS Read Table 

Through the use of a table-driven BIOS, the 
configuration flexibility needed for this application could 
be achieved. The use of the indirect call allows all device 
specific code to be isolated in a single file. Therefore, a 
separate file can be constructed for each unique peripheral 
device and can be included in the BIOS by the use of the 
"include" assembly command. An additional benefit of this 
type of approach is that it allows for the systematic 
addition or deletion of hardware devices to or from the 
system without disturoicg the basic BIOS code. 

The table-driven concept also provided an improved 
program develpment scheme and a more logical approach for 
the implementation of the RSMSI Data Warehouse memory unit. 
Hammond had previously written the code to support the Intel 
1201 Floppy DiSiC Controller. A spare 1201 controller was 
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available and was placed in the iCS-80 chassis. With a few 
minor modifications to the BIOS, it was operational in a 
very short time. Since both ALTOS and MBS single-density 
diskettes were fully compatible, programs could now be 
written, assembled, and converted to executable code and 
then be taken directly to the iCS-S0 for execution. This 
reduced the amount of time needed to correct errors or 
modify a program and greatly facilitated code generation. 

Because devices could be added to the BIOS 
independently, it was decided to utilize the i201 floppy 
disk drive as a developmental aid and to subsequently 
implement the RSMEX floppy disk first followed by the hard 
disk. The MBB-80 would be substituted for the iSei once the 
REMEX interface was completed. This implementation scheme 
is explained in more detail in the following sections. 

3. INTERFACING THE RSMEX DATA WAREHOUSE 
!• floppy Disk Drive 

During the testing of tne initial REMEX READ/WRITE 
low-level routines, it was observed that the REMEX would 
only intermittently complete a packet operation. Wnen it 
did not complete successfully, the program looped infinitely 
checking the packet status word (see Figure 4.1) for a value 
other than a zero, indicating that the REMEX had either 
completed the operation or that an error had occurred. When 
multiple packets were sent out on the Multibus, completion 
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codes were occasionally returned in the command pacicet 
status word. Vhen DDT86 was used to trace through the Read 
routine step by step, the same results were obtained. 
However, this procedure did verify that command packets were 
being constructed properly and that the packet address was 
being transmitted to the Multibus correctly. 

Meit, a Multibus Monitor Board was used to observe 
the action on the Multibus and confirmed that all data was 
correct. This led to speculation that either the interface 
board was not transmitting the correct information to the 
REMEX or the RBMEI was not processing packets correctly once 
it received the information from the interface board. 
However, further hardware testing revealed that both the 
REMEX and the Interface were functioning normally. 

The source of the problem was found more by accident 
than by design. Documentation [Ref. 8 : p. 2-4:] indicated 
that the Interface Assembly would wait from 0 to 15 host CPU 
cycles between consecutive DMA operations. The exact number 
of cycles can be jumper selectable by the DMA Throttle. 
Therefore, polling the packet status word for a completion 
code was thought to provide sufficient CPU cycles to allow 
the process to continue. However, when the wiring diagram 
of the Interface Card Assembly was examined, it was 
discovered that the DMA Throttle was controlled by the 
number of Multibus cycles and not by the number of CPU 
cycles. Since the Throttle was set to the factory default 
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position, one additional Multibus cycle was required before 
the interface board could execute its next DMA operation. 
Because there was only a single host computer in the system, 
no additional Multibus accesses were made. This explains 
why marginal success was obtained by sending multiple 
packets since this provided the additional Multibus 
accesses. The DMA Throttle jumper was removed which allowed 
the Interface Card Assembly to respond immediately with a 
DMA operation once it acquired control of the Multibus. 
Subsequent packet operations were successfully completed. 

Once the READ/WRITE driver routines had been 
debugged, the next step in the floppy disk implementation 
was to incorporate these routines into the table-driven 
BIOS. A separate "include" file called RIEL0P1.A66 was 
established to contain the necessary device-specific 
subroutines. Of the seven BIOS functions that had to be 
addressed, only the HEAD and WRITE functions required code 
in addition to that contained in the basic BIOS routines. 
Each of the other functions were returned directly to tne 
main B lOS . 

The command packet was allocated memory space in the 
data section of RXEL0P1.AS6. However, the packet parameters 
had to be supplied from the BIOS variables in order to 
access the file requested by the CP/M file manager. Figure 
4.4 depicts the READ packet for the REMEX floppy disk drives 
used in this implementation. 
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Figure 4.4 

REMEX Floppy Disic Read PacJcet 

From Chapter 3, recall that word d of the command 
paciet is composed of a modifiers section, function code 
block, and unit id number. The value of 10h in the modifiers 
section merely indicates that a single packet is being sent 
and that all automatic error routines are in effect. The 
function code block (1) specifies a READ operation. Since 
the REMEX floppy disk drives were chosen to be equivalent to 
CP/M logical disk drives 1 and 2 (B: and C:) for this 

implementation, the CP/M drive number and the REMEX unit id 
for the two floppy disk drives were equivalent. Therefore, 
the desired CP/M disk number is directly inserted into the 
packet. The 16 -bit BIOS variable "track” wnich contains the 
requested track number is placed into word 2 of the command 
packet. Word 3 which contains the head and selected sector 
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number is formed by inserting a zero in the upper byte 
indicating that the floppy dislcette will only be addressable 
on a single side and placing the BIOS variable "sector" in 
the lower byte. The 20-bit address of the CP/M DMA buffer 
which will receive the requested data is computed from the 
DMA base and offset. The extended address bits (bits 16-19) 
are entered in the lower byte of word 5. For example, if 
the local memory of an iSBC 86/12A is configured to respond 
to Multibus memory segment zero, the extended address bits 
will be equal to 00h . However, if the local memory were 
configured to respond to Multibus memory segment 1000, then 
the extended bits would be 01h. The remaining 16-bit address 
is placed into word 4 of the command paclcet. 

Word 6 which contains the transfer word count caused 
the most problems with the floppy dislc interface. The major 
difficulty encountered was the direct result of poor and 
misleading documentation. The RSMFX technical manual for 
the interface board indicates [Ref. 8 : p. 2-4] that the 
REMSX can selectively transfer data to the host computer in 
either 8-bit or 16-bit words by setting a single switch. 
Since CP/M worics with 8-bit words, the switch was set 
accordingly and a transfer word count of 128 S-bit words was 
placed in the packet and sent to the REMSX. At first, this 
seemed to work correctly because a directory of the diskette 
was read without difficulty and files could be transferred 
to and from the diskette without error. However, problems 
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were encountered when attempting to execute a file that was 
on the diskette. An error message of “FILE NOT FOUND” was 
displayed intermittently. If a file was found, the program 
would not execute correctly. In both cases, the system 
partially crashed and no other operations could he 
accomplished, despite the fact that the prompt character 
continued to function normally along with an occasional 
error message. 
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correctly and showed that the data was being placed in C?/M 
DMA buffer. 

Numerous changes and experiments were made 
attempting to locate the cause of this problem. Printouts 
of the diskette's directory were obtained without error. 
Hardware was tested and retested with negative results. 
Finally, a memory map of the operating system was printed 
after obtaining the directory from a diskette in the MD3 
single density disk drive system. This was compared to a 
memory map of the operating system after the directory of 
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the same diskette was taken from the RSMEX floppy drive. It 
was here that the error was uncovered. The REMEX was 
transferring 256 8-bit words into the DMA buffer space, not 
the 128 8-bit words as believed. Thus, the extra data was 
overwriting portions of the CP/M-86 RIOS causing the system 
to partially crash. The problem stems from the fact that 
the REMEX wants to know how many 16-bit words it should 
transfer. This is completely independent of how the REMSX 
will transmit the data. Therefore, since a C?/M sector of 
128 bytes is equivalent to 64 or 40h 16-bit words, 40h was 
placed in word 6 of the command packet and no further 
problems were encountered. 

2. Hard Disk 

Although the implementation of the hard disk was 
very similar to the floppy disk drives, there were some 
notable exceptions. First, the REMSX had a sector size that 
was a multiple of the standard CP/M sector size of 128 
bytes. This necessitated the use of a sector 
blocking/deblocking routine to resolve this disparity. 
Second, since the REMEX hard disk has four (4) separate 
heads, the question of how to divide up the disk had to be 
resolved. The most logical and straightfoward method was to 
let each head represent a separate CP/M logical disk drive. 
Each drive would then be able to address up to 4.5 megaoytes 
of data. With these ideas in mind, the hard disk interface 
was begun. 
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Changes had to he made to the Disk Definition and 
Configuration Tables. In the file CPMMAST.DEF, CP/M logical 
drive numbers 3, 4, 5, and 6 were added to the table. Each 
drive number had a disk definition statement that described 
the physical storage capabilities of a single head of the 
hard disk. The disk definition variables were determined as 
presented in Chapter 3. Now, the BIOS would support a total 
of seven (7) peripheral I/O devices: an i201 floppy disk 
drive, two RSMEX floppy dis^ drives, and four REMEX hard 
disk drives. Later, the MBB-30 bubble memory would be 
substituted for the 1201 disk drive. Also, additional 
labels had to be added to the tables in the file CPMMAST.CFG 
to vector the BIOS function calls to the appropriate 
subroutines located in the "include" file RXHARDl.AcS. 

The most difficult obstacle to overcome in this 
portion of the implementation was to determine the REMEX 
hard disk sector size. The sector size can be either 123, 
256, 512, or 1024 bytes. Initially, attempts were made to 
reformat the hard disk in accordance with Reference 7. 
Switches 31 and 32 located on the Formatter II Card Assembly 
were set to configure tne hard disk with a 512 byte sector 
size. A program was then written which built a command 
packet to execute the REMEX built-in formatting routine 
[Ref. 7 : p 3-23]. However, repeated attempts failed to 
produce a successful format operation. The REMEX also 
supports a built-in maintenance program that tests the Hard 
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Disk Format operation. When this program was run, multiple 
error messages were returned indicating that the format 
program was inoperative. 

Since data had been written to and retrieved from 
the hard disk during low-level driver testing, it was 
obvious that the REMFI had been previously formatted. The 
next step was to determine exactly wnat format was used. 
This was not as easy as might be expected. During the power 
up sequence, the REMEX will check the sector size switches 
and configure its internal circuitry to process sectors of 
that size even if the switch postions do not represent the 
actual format of the hard disk. That is precisely why these 
switches must match the actual physical sector size in order 
for read/write operations to work correctly. This fact 
caused considerable confusion in the interpretation of tne 
error messages obtained by attempting to access the border 
sectors (104, 67, 39, and 21 for sector sizes of 128, 256, 
512, and 1024 bytes respectively). However, it was finally 
determined that the sector size was 512 bytes. 

Since the REMEX sector size was a multiple of the 
128-byte CP/M sector size, a sector blocki ng /deb locking 
routine was needed to coordinate the access of CP/M sectors 
with the physical sectors of the hard disk. In this case, 
there were four (4) CP/M sectors contained on each hard disk 
sector. On each BIOS call, the CP/M-66 3DCS includes 
information that can be used to provide effective sector 
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blocking and deblocking. The sector blocKing/deblocking 
routine used in this implementation is distributed by 
Digital Research in skeletal form [Ref. 6 : p. 70] . 

The blocking/deblocking algorithms map all CP/M 
sector read and write operations through an intermediate 
buffer called "hstbuf". The size of this buffer is 
equivalent to the H2MSX sector size (512). During a read 
operation, a 512-byte sector of data is read into the 
"hstbuf" or host buffer from the R5MEX hard disk. Since the 
host buffer now contains four CP/M sectors, the desired 128- 
byte sector is obtained by correctly offsetting into the 
host buffer. This data is then transferred to the CP/M DMA 
buffer defined by the DMA base and DMA offset variables. 
Similarly, during a write operation, four C?/M sectors are 
written to the host buffer. The data is then transferred to 
the REMEX hard diSK and stored on a single 512-byte sector. 

Within the blocking/deblocking routine itself, the 
values and variables which relate to CP/M sectors are 
prefixed by "sek", wnile those related to the REMEX hard 

disk are prefixed by "hst". The SELDSK, SSTTRK, SETSEC, 

SECTRAN, and SSTDMA entry point routines were transposed 

into the REMEX nard disk "include" file. These subroutines 

store values for later use and SECTRAN translates CP/M 
sector values into the corresponding physical sector. The 
READ and WRITS entry point labels were placed in the 
read_table and write_table respectively, while the actual 
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REMEX hard disk read and write low-level drivers were 
incorporated at the READ3ST and WRITEHST entry points. 

The command packet was constructed from the 
following variables: "hstdsk" which represents the host disk 
number, ’’hsttrk” which is the host track number, and 
"hstsec” which cooresponds to the host sector. The host disk 
number is transformed into the appropriate head number and 
is entered into the upper byte of word 3 of the command 
packet. The memory segment and offset of the host buffer 
(hstbuf) is translated into a 20-bit address. The extended 
bits (16-19) are entered into the lower byte of word 5, 
while the remaining- 16-bit address is placed in word 4 of 
the command packet. For the RSMEX hard disk, we want to 
transfer 512 bytes or 256 16-bit words. Therefore, the 
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transfer word count (word 6 ) was set to lid^h , The REMEX hard 
disk Read packet is shown in Figure 4.5. 

3. Initial MultiriSBC 66/12A SYStern 

The above implenenta t ion produced a CP/M -66 BIOS 
that supported the MB3-80 bubble memory and the R2MEX Data 
Warehouse floppy and hard disic drives. The original master 
iSBC S6/12A {ffl) was booted from the MB3-S0 and had its 
onboard memory swi t ch-ard-jumper selected to be accessible 
from the Mulitibus beginning at memory segment zero. Data 
transferred from the RSMEX would be put directly into the 
CP/M DMA or Host Buffers via DMA operations. The next step 
was to introduce a second iS3C 86/12A into the system which 
would also utilize the CP/M -86 operating system. 

It was decided to use the 32K common memory to hold 
a bootloader program that coula be usea by the slave iSBC 
86/12A computers to boot the CP/M -66 system. A utility 
program, LDCPM.AS 6 , was written to place a copy of CP/M-56 
into common memory which was especially configured for the 
slave computers. k second utility, LDB00T.A86, was used to 
transfer a copy of the bootloader program (B00T.A66) into 
common memory. The resulting common memory map is snown in 
Figure 4.6. CPMSLAVS.CMD was identical to the CP/M -06 system 
used for the master iSBC S6/12A except that it supported an 
iSBC 86/12A whose local memory was accessible from the 
Multibus beginning at memory segment 1000 h. When initiated 
from the iSBC 86/12A monitor, the bootloader program would 
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Corr.mon Memory Map 

transfer tiie CP/M-86 slave system from common memory into 
local memory beginning at 40:0000h. Cnee the transfer was 

complete, control would be passed to the RIOS to initialize 
the system. It must noted that all these programs must 
reside on CP/M logical drive Pi^ 

This scheme, although utilizing the DMA capability 
of the REMEX to the maximum extent possible, would require a 
different CPMSLAVE.CMD file for each iSRC 66/12A added to 
the system. Each computer's local memory would have to be 
placed in a separate 64K blocic within the one-megabyte 
address space available to the Multibus and these page 
numbers would be have to be entered in the lower byte of 
word 5 in the command packet. This organization is somewhat 
awkward and exhausts a large portion of common memory if 
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several computers are used. Therefore, a more acceptable 
alternative was needed. 

■ C. SYNCHRONIZATION AND PROTECTION 

1 • Synchrgniza ti on of Read/Write Operations 

With two active iSBC 86/12A computers in the system, 
the synchronization of read/write operations had to be 
addressed. Since the HEMEX could queue up to eight (S) 
command packets internally, it was initially felt that this 
feature would provide adequate synchronization of the I/O 
requests from the independently operating computers. 
However, when simultaneous multiple transfers were attempted 
between the CP/M hard disk logical drives, sporadic errors 
occurred. Inspection of the READ and WRITE routines in the 
hard disk "include" file (RXEARDl . A66) revealed that there 
was nothing to prevent a clash of both iSBC 36/12A computers 
if they simultaneously attempted to send a command packet 
address to the HEMEX Interface Card Assembly. Since the 
packet addresses were sent in three (3) single-byte Multibus 
transfers, it was indeed possible for the values sent to the 
interface board to become intermixed. Also, once the most 
significant byte of tne packet address is sent, the 
interface immediately signals the HEMEX that tne packet 
address is complete and ready to be transferred. However, 
this may not be the case. Consider the case where computer 
#1 has transferred the extended address and the least 
significant bytes of the packet address to the Packet/D'^A 
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Register. Computer #2 then sends the extended bits of its 
packet address. Since each computer's memory begins on a 
different page, the extended bits will be different for each 
iSBC 86/12A. Computer #1 now regains control of the Multibus 
and sends its most significant address byte. The Remex will 
now read the packet located in computer #2's address space 
rather than the packet in computer #l's address space. This 
will certainly cause severe problems. 

Initially, the section of code used to send out the 
packet address was identified as a critical section. A 
semaphore was then defined to control the access to the 
critical section. In order that all active iSEC S6/12A 
computers could have access to the semaphore, it was placed 
in common memory and could take on a value of either 0 or 1 
indicating that the resource was either busy or free 
respectively. If it was a 1, the requesting computer would 
set it to 3, send the three bytes of the packet address, and 
then reset it to 1. If the requestor found that the 
semaphore was equal to 0, it would delay and then recheck. 
This checking process was implemented using the LOCK XCHG 
instruction to provide exclusive use of the Multibus. 

When simultaneous multiple file transfers were again 
attempted, errors still occurred indicating that there was 
still some interference on the Multibus. This probably 
occured when the registers of the interface were set up for 
a DMA data transfer and a packet address was then written 
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into the Paclcet/DMA register before the data could be 
transfered. At any rate, a more inclusive synchronization 
scheme was required to ensure that a single iSBC 66/12A 
read/write operation could be completed without encountering 
contention from the other computers in the system. 

Since it was desirable to have all iS3C 86/12A 
computers configured alike, it was decided to adopt a 
software approach to the synchronization problem rather than 
the conventional monitor approach. The method chosen was 
based on sequencers and eventcounts [Ref. 12] . This method 
is modeled after the "ticket/server" system used in many 
stores where services are performed. When the customer 
arrives, he takes a numbered ticket and then waits for his 
number to come up before being served. The server works in 
ticket number order. The Implementation of this scheme is 
very s tra ight f oward and nad been previously used by Hammond 
[Ref. 3]. Two 16-bit counter variables, "ticket" and 
"server", were placed in common memory. The value 0 was 
reserved for the ticket number indicating that another 
computer was presently modifying the ticket number. 

Exclusive access to the ticket number was provided by the 
LOCK XCHG instruction. An algorithmic language 
representation of the sequencer routine is given in Figure 
4.7. The delay used in the Await Subroutines was used to 
prevent Multibus contention. "Request" is called prior to 
each read or write operation to gain exclusive access to the 
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Primitive Subroutines 

>j! 3 jc :;c ^ 3 ji >}: :jc 5 jc:jc s>: Jjs 3;: j;c a;t jj£ 5 JC # act 3;: 5 }: 5 ^ a;c :Jc ajK :j: > 5 : sjc 35: : 5 c ^ 5 je>;{ a{< s;s :{s :(5 3 ^: 5 :? >;c 5 CC :®c :{t 5 tc Jjc a;t^ 

ticket: Jreturn a ticket number 

customer no. = ticket no. 

inc ticket no. 

ret 



await: Jdelay until customer no. = 

Iserver number 

while customer no. < server 
delay 
ret 



advance; 



jinc server 



inc server 
ret 

5jc 3 Ck 55c 3{s 35c 35c s;: 35s 55c 35c 35c 5|s : 4 c Jjs 3}; :;£ :;s 35: 35c 35: > 5 C 3}c 35 : 35c 3 Ct 35 t 3 {t 35s : 5 c 35; 3 JC 3;: 35c 55s 3 j: :;c s;c 3 JC s;: :;c 35c 3j: 5^ :;c 35: sjt :;t 3 JC 3jt 356 5;s ^ 

Entry Point Routines 

3jc 35c 35c 35c 35c 35:35c 35c 35c 3|c3;c 35c 35c 35c 3CC 35; 35c :5s 35c 35c 35c 3;: :5s 35s 35; :5s 35c 35s 35:35: 35c 35c 35:3;: :4c :}( 35c :5c 35c 35; :5c 35c 35; 35c 35s 35c :5s 35c 3;: 35: 35: :5c 35:3;: 35s 35: 

request; »get resource 

call ticket 
call await 
ret 



release: jrelease resource 

call advance 
ret 



Figure 4.7 
Sequencer Algorithm 
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shared resource. Once the operation is complete, "release" 

is called to free the resource by incrementing the server 

0 

number which allows the next I/O function to be executed. 
When the sequencer code was implemented into the read/write 
routines for each of the peripheral I/O devices, no further 
errors were noted. 

2. Common Memory Xead/Write Routines 

As alluded to earlier, the CP/M-S6 BIOS which uses 
DMA operations to transfer data between tne iS3C S6/12A 
computers and the Eemex Data Warehouse requires a unique 
BIOS for each computer in the system. This places a severe 
limitation on further system expansion and complicates the 
system configuration control requirements. Futnermore, this 
type of implementation requires that at least a portion of 
the iSBC £6/12A's local memory be accessible to tne 
Multibus. One of the principal goals of this thesis was to 
provide a system in which all computers were isolated from 
one another. Obviously, this implementation does not support 
this goal. It also results in an awlcward bootloader 

arrangement in common memory and requires that all versions 
of CP/M-S6 needed for system operation be accurately updated 
should any changes or modifications occur. Therefore, a 
more acceptable BIOS implementation had to be found. 

The resulting implementation routed all data 

transfers through a common memory buffer. The size of this 
buffer was set to correspond to tne largest physical sector 
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Common Memory Read Operation 



within the system which was the 512-hyte sector of the RSMEX 
hard disk. The additional code required for each read/write 
routine was minimal since its only function was to transfer 
a given amount of data between local and common memory. A 
data flow diagram depicting a typical read operation from 
the REMEX is shown in Figure 4.S. For illustration, consider 
a CP/M initiated read o'peration from the REMEX nard disit. 
The command packet will be constructed as before except that 
the 20-bit common memory buffer address will replace the 
host buffer address in word 4 and the lower byte of word 5 
of the packet. This will result in the desired data being 
read into the common memory buffer. When this operation is 
complete, the requesting iSBC S6/12A will then transfer the 
data in the common memory buffer to the host buffer located 
in the data section of the CP/M BIOS. This procedure is 
entirely transparent to the CP/M BDOS. A write operation is 
similarly completed. First, the data in the host buffer is 
written to the common memory buffer. Next, a packet is sent 
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to the interface which transfers the data from common memory 
to a specified head, track, and sector of the hard disk. The 
required changes were made to the "include" files for the 
MBB-60 Bubble memory, the HEMEX floppy disk drives, and the 
REMEI hard disk drives and the files were renamed 
MBC^DSK .A86 , RXFL0P.A86, and RXHARD.A86 respectively. These 
files appear in Appendices C, D, and E. 

The common memory routines produced several 
improvements to the overall system design. First, all iSBC 
S6/12A computers could be completely isolated. Each of the 
four computers used in the system was jumper configured so 
that all onboard memory was reserved totally for local CPU 
use and could not be accessed from the Multibus. This 
provided the required protection for each computer's local 
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tremory. Second, only a single copy of the CP/M-86 operating 
system was required for all of the slave computers since 
data transfers were locally initiated. In fact, the only 
difference between the slave and master versions involved 
the initialization of the synchronization variables and the 
log-table. A memory map showing the configuration of common 
memory is presented in Figure 4.9. 

3. PisK Write Protection 

The ticket/server synchronization routine ensures 
tnat single iSBC 86/12A read/write operations can be 
completed without interference. However, this is not 
sufficient to provide the necessary write protection to the 
shared devices in a system of multiple computers each 
running CP/M-S6. Consider the case of two processors trying 
to write to the same CP/M logical disk. CP/M reads the disk 
directory and constructs an allocation vector in the BIOS 
that indicates the logical blocks on the disk that have not 
been written to previously. 3ach iSBC S6/12A then proceeds 
to write its data file to the unallocated blocks in 
sequential order. Although the individual write operations 
were synchronized, the result is still overwritten and 
garbled data. Therefore, this implementation institutes a 
read/write strategy that allows all computers to read data 
from all the shared devices but only write to a single 
device to prevent files from being overwritten. Moreover, 
it was also desirable to be able to select any of the shared 
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devices for write operations from each of the four system 
console positions. 

A logon and logout procedure was developed to ' 
control the write access to the various peripheral devices 
through the use of a table located in common memory. This 
table has a entry for each device in the system (.Figures 
4.13 and 4.11). Before the user is permitted to boot 
tne CP/M he is asxed for his console number and the C?/M 
drive that he wishes to log onto (write to). The CP/M drive 

A: B: C: D: I: F; G: 

logtbl IMBB-S0IFLOP1 1FL0P21HAPD11 HAHBP ! hARD3 1 EARD4 



Figure 4.13 
Login Table 
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Final Common Memory Configuration 

number is stored in a local variable called "user” which is 
used as an offset into tne log table. The log table is then 
checked to determine if the desired disk has already been 
logged onto. If not, the console number is entered into the 



log table at an offset corresponding to tbe given device. 
Otherwise, the user is asked to select another disk. To log 
out , the user types the command "logout" which places a zero 
(free) in the log table at an offset equal to the user 
number. Each CP/M logical disk drive requires its own copy 
of the log out routine (L0G0UT.CMD) so that it can be 
executed from every disir drive. 

Within the BIOS, when a write operation is 
requested, the variable "user" is compared to the CP/M 
logical disk number. If they are equal, the write operation 
is permitted to continue. If not, the user is informed that 
write operations are not permitted to that disk drive. This 
guarantees that no two iSBC 36/12A computers can write to 
the same shared disk. 

D. SUMMARY OF SYSTEM GENERATION 

The following descriptions provide step-by-step 
procedures on how to create the BIOS for this implementation 
of the CP/M-86 operating system, how to step up the MBB-60 
bubble memory board in the MBS double density system, and 
how to start up the multi-user CP/M-66 system. 

1 • System Bios C reatipn 

a. Develop separate files for each I/O device being 
sure to address the seven device specific functions in each. 
In this code, before any Multibus access include the 
command "call request” and upon completion of a Multibus 
access include the command "call release". 
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b. Ensure that all I/O is accompli sbed via the 
common memory I/O buffer which extends from Ee0t5:100 to 
S300:300. Develop a transfer routine for moving data to and 
from the common memory buffer and the host computer. 

c. Decide upon the logical hardware configuration 
as will be seen by CP/M-e6 . Based on this configuration, 
develop the Disk Parameter Table which will be used as the 
source file for OENDEF.CMD to produce a ".LI3" file. Also, 
using this same hardware conf iguration and the I/O device 
files, develop the label tables in CPMMAST.CEO for the seven 
device specific functions. 

d. In the BIOS use the "include" command for all 
I/O device files, the label table ( CPMMAST .CFO ) , and the 
DiSK Parameter Table ( CPMMAST .LIB ) . The files SYNC.ASd and 
LOGIN. AS6 must also be included, but require no 
mod if icat ions . 

e. Assemble the BIOS using ASflS6.COM. Using 
ASM66.CMD may generate forward reference errors and require 
the rearrangement of some included files in the BIOS. Two 
assemblies must be made. The first must be assembled with 
the master conditional assembly switch set to true in order 
to create the master BIOS. The second must be made with the 
switch set to false in order to create the slave BIOS. 

f. Concatenate the resulting hex files with CPM.H86 
to form CPMMAST. H86 and CPMSLAVE .H66 . Use the CP/M utility 
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conmand GENCfiD.CMD (GENCMD CPMMAST 8090 code[a40]) to 
generate the executable command files. 



g. Transfer CPMMAST.CMD to the MBB-80 bubble memory 
board as CPM.STS. Transfer CPMSLAVE.CMD to drive L: of the 
REMEX . 

2. Setting up the ^B|r60 in the MDS System 

a. Remove the Intel 8080 microcomputer and the 
associated memory boards from the MDS double density system. 

b. On the iSBC 66/12A #1, place the switches 1-16 
and 8-9 on DIP switch SI in the closed position. Install a 
Jumper between pins 127 and 126. If there are Jumpers in 
place for the clocic, pins 103 and 105, remove them. 

c. Insert the iSBC 66/12A #1 and the MEB-60 board 
with the backplane into the MBS chassis. 

d. Turn the power to the KBS chassis and the disk 
drives on. Once these devices are running, apply power to 
the KBB-80 board by setting the memory protect switch on the 
backplane to the "run" position. Now, the CP/M-86 operating 
system can be booted from a double density diskette by 
entering the command G-FFB4:0. The system booted should be 
one that is capable of addressing the bubble memory as a 
diskette. 

e. To format the MBB-80 bubble memory execute tne 
program MB80FMT.CMB and use 6000H as the base address for 
the controller. Execute LBCOPY.CMB using LBRMB80.CMB as the 
source file. This will place the loader on tracks 0 and 1 
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of the MBB-80 bubble board. Finally transfer CPMMAST.CMD to 
the bubble as CPM.STS. 

3* System iQi tiali zat ion 

a. Insert four iSBC 86/12A computers into the iCS- 
80 chassis. One computer must have a jumper on pins 103/104 
and 105/106. These connections supply the clock for the 
Multibus. All computers should have pins 112 and 114 
connected by a jumper wire. This ensures that the 
computer's local memory is inaccessable to the Multibus. 
Also on all computers, only position 3-9 on DIP switch SI 
should be closed. All other positions should be open. 
Finally, insert the MB3-80 bubble memory board, tne 32K 
common memory board and the R2MEX interface board into the 
iCS-80 chassis. 

b. Turn the iCS-30 power switch on. 

c. Power up the REMEX in accordance with Ref. 7 and 
turn the M33-60 memory protect switch to ”on”. This switch 
is located in the rear of tne iCS-80 chassis. 

d. When the REMEX hard disk has timed out and the 
ready light is on, enter the command GFFD4:4 from the 
console attached to iSBC 86/12A #1 to boot CP/M-36 from the 
MBB-S0. The synchronization variables and the log table 
entries will be initialized in common memory. 

e. Select drive D: 
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This will 



f. Execute LDCPM located on drive C; . 
load the file CPMSLAVE.CMD into common memory starting at 
E000:500. 

g. Execute LDBOOT located on drive D: . This will 
place the file BOOT.CMD into common memory starting at 
S000 :400 . 

h. Now, CP/M-66 can he hooted on any iSBC S6/12A 
computer by entering the command 5E000:0400 from the monitor. 

i. When a session is completed, enter the command 
LOGOUT to logoff the system. 
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V. RESULTS AND CONCLUSIONS 



A. GENERAL RESULTS 

The ultimate goal of this thesis was to develop a multi- 
computer "protected” C?/M-86-hased system that shared memory 
storage devices. This goal was accomplished and the 
resulting code is located in the Appendices. The major 
product produced by this thesis is a completely operational 
multi-user development station. The CP/M BIOS is completely 
table-driven and can be reconfigured for different hardware 
configurations in under twenty minutes. This feature alone 
is a significant improvement over the standard BIOS marketed 
by Digital Research. In addition, it should be quite easy 
to expand the current system to permit more users or add 
additional I/O devices. 

The system provides user protection in several forms. 
No user, once logged onto the system can destroy, either by 
design or by accident, anothers user's files or local CPU 
memory. Eowever, any single computer can destroy common 
memory, but it is a simple matter to restore it. 
Furthermore, the logon and logout procedures prevent two 
users from simultaneously logging onto and writing to the 
same CP/M logical disk drive. 
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B. EVALUATION OE THE IMPLEMENTATION 

To evaluate system performance, two tests were 
conducted. The first test involved assembling a 3K and then 
a 241 file with a single computer logged onto the system. 
The assembly time was recorded using a conventional 
stopwatch. Next, two computers were used to simultaneously 
assemble the same file, followed by three and then four 
computers. The results of the test are shown in Table 5.1. 

Table 5.1 

REMEX Assembly Times In Seconds 

FILE ONE TWO THREE FOUR 

SIZE COMPUTER COMPUTERS COMPUTERS COMPUTERS 

3K 12.9 22.1 25.1 28. & 

24K 211.1 246.7 257.3 275.5 

Table 5.2 

MP/M Assembly Times In Seconds 

FILE ONE TWO THREE FOUR 

SIZE USER USERS USERS USERS 

3K 22.3 XXX 

24K 323.2 XXI 



One might expect that two computers would take twice as 
long to assemble the same program and three computers three 
times as long. However, except for the initial contention 
for the I/O devices, all computers could assemble the files 
in parallel. This accounts for the fact that there is not a 
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linear relationship between the number of computers 
operating in the system and the assembly times. 

To provide a means of comparison, an attempt was made 
to run the same test under the MP/M operating system. 
However, MP/M would not permit more than one file to be 
assembled at the same time. In fact, on several attempts, 
the entire system crashed. The results of this test are 
shown in Table 5.2. 

The second test involved a file transfer utilizing the 
CP/M-66 utility PIP.CMD. Since all operations were I/O 
intensive, this test represented a worse case scenario. The 
first run consisted of transferring a 16K file with only one 
computer operating in the system and recording the time it 
took to complete the operation. Then two and finally three 
computers were used to execute the identical PIP command at 
the same instant. The time it took for all computers to 
complete the task was recorded. The results of these tests 



are shown 


in Table 5.3. 
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not 


possible 
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computers 
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files to 


a single 


bubble devic 


eat 



at the same time.) 

To provide a comparison for the above results, the same 
test was run on the MP/M system. Although tne two system 
configurations are different, they do offer some basis for 
comparison. However, in the MP/M system, only operations 
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Table 5.3 

F.ZMEI Transfer Times In Seconds 
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HARD DISK 
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BUBBLE DEVICE 
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FLOPPY DISK 
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THREE COMPUTERS EXECUTING PIP 


HARD DISK 


10.6 


X 


X 


BUBBLE DEVICE 


18.4 
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X 


FLOPPY DISK 


49 .7 


X 


X 



between the hard disic and floppy disi were possible. The 
results of this test are shown in Taole 5.4. 

From these results, it can be seen that the multi-user 
CP/M-S6 system has a slight performance advantage for single 
user disk operations. Wnen more than one user is operating 
in the system, this performance advantage becomes very 
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Table 5.4 

MP/M Transfer Times In Seconds 
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X 


FLOPPY DISK 
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significant for transfers made between areas on the hard 
disk. However, the RSMEX floppy disk drives are slower. 

Since the REMSX hard disk can be used to emulate the 
"signal processor" functions of the AEGIS system, a third 
test was conducted to determine the optimum skew factor for 
consecutive read operations. A low-level routine was 
written to continuously read sectors from the hard disk into 
common memory. After each read operation, a counter was 
incremented. When five read operations had been completed, a 
character was printed to the CRT screen. The time it took 
to print 80 characters to the CRT is recorded and 



90 



Table 5.5 



REMEX Winchester Disk Skew Times 
in Seconds 



SKEW 


TOTAL 


SKEW 


TOTAL 


FACTOR 


TIME 


FACTOR 


TIME 


0 


10.00 


20 


5.25 


1 


10.35 


21 


e. KK 


2 


10.55 


22 


5.60 


3 


13.95 


23 


6.10 


4 


11 .25 


24 


6.35 


5 


11.45 


25 


6.60 


6 


11.70 


26 


6.85 


7 


11.95 


27 


7.10 


8 


12.20 


28 


7.35 


9 


12.55 


29 


7.55 


10 


12.75 


30 


7.80 


11 


13.05 


31 


8.05 


12 


13.40 


32 


6.30 


13 


13.45 


33 


8.65 


14 


13.70 


34 


8.85 


15 


4.20 


35 


9.20 


16 


4.35 


36 


9.45 


17 


4.55 


37 


9.65 


13 


4.35 


38 


9 . 8c 


19 


5.05 






approximates 


the time it took to 


conduct 400 


separate 


operation s . 


During the first run 


, the skew 


factor wa: 


to zero. 


Therefore, no sectors 


were skipped between 


operat ions . 


In the subsequent runs, the skew factor 



incremented by one for each successive test. The results 



rea d 
set 
read 
wa s 
are 



shown in Table 5.5 and Indicate that a skew factor of 15 is 



optimal for reading data from the REMEX hard disk. 



C. RECOMMENDATIONS FOR FUTURE WORK 

There are several possible opportunities for future 
projects involving the REMEX hard disk and the multi-user 
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CP/K-86 system. Th-e first and foremost is the use of the 
system to emulate the AEGIS system. Several AEGIS system 
modules have already been developed and could be run on 
dedicated iSBC 66/12A computers using the REMEX hard disk to 
supply simulated radar data. In the present hardware 
configuration, four system modules could be run concurrently. 

Eowever, there are other smaller support projects which 
would increase the capability and utility of the system. 
There is an urgent need for a more sophisticated text editor 
or word processor. Without one, the system will not be used 
to its full capabilities. Translating the 8080 assembly 
language code of BTED.COM into S0b6 assembly language would 
provide a more usable text editor than the one currently 
provided by Digital Research - ED.CMD. 

Another possible project is to develop a boot loader 
program for the REMEI Data Warehouse. As the system is 
currently designed, the CP/M operating system must be 
initially loaded from either the M3B-80 or from the MDS 
single density system. This would allow CP/M to be booted 
from any of the memory storage devices currently in the 
system. 

A more ambitious project would oe to design a boot 
loader which permitted the user to boot not only the master 
CP/M-86 operating system directly from the REMEX Data 
Warehouse, but the slave CP/M-S6 operating system as well. 
This would relieve the master system of the task of loading 
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the CP/M slave system and the boot loader program into 
common memory prior to booting the other slave computers. 



Furthermore, it would free a larger portion of common memory 
for general use and decrease the number of system variables 
that would have to be reconstructed should common memory be 
destroyed. The programs LDCPM.A86, LD300T.A86 and B00T.AS6 
which are already written could be combined to form the 
nucleus for such a program. Once operating correctly, the 
program would have to be loaded into an iSBC S6/12A 3PROM 
where it would be accessible to the monitor. 

The final project could alter the CP/M-86 BIOS to 
include the Micropolis Winchester hard disk, the MBS double 
density disk drive system, and the newly acquired 256K 
bubble memories. The code for the Micropolis hard disk and 
the MDS double density disk drive system has already been 
written and only needs to be put into the table-driven BIOS 
format. The implementation of the new bubole memories 
should be very similar to that of the MBB-8C. 



1 
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APPENDIX A 
PROGRAM DISCRIPTIONS 

I. MBB-E0 BUBBLE MEMORY PILES 

A. MB80PMT.CMD: This program is used to initially 
format the MBB-80 bubble storage device as a single density 
disk drive. When the program is executed it will prompt the 
user for a segment address. The address of £000 must be 
entered. The program will then set the controller base 
address to 8000h and write the correct byte patterns on the 
bubble memory system to give it the appearance of a 
diskette. [Ref. 2 ; p. 86 and p. 159] 

B. MB80ROM.A86; This file contains the source code 
necessary for bootstrapping tne system from tne bubble 
memory device. It has been loaded into an EPROM and placed 
on the motherboard of the iSCB 86/12A computer labeled #1. 
It is executed by entering the comm, and GFFD4:4 into the 
monitor of the computer. The program will then place the 
system loader into memory and transfer control to it. [P.ef. 
2 : p. 187] 

C. LDRMB80.CMD: This is the loader program tnat must 
be placed on the bubble's tracics 0 and 1. It will locate 
the file CPM.STS on the bubble memory device, load it into 
memory and then transfer control to the operating system. 
The BIOS for this program is created using MB3I0S.A86 with 
the loader conditional assembly switch set to true. 



94 



1 



jS.;. 
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D. M33I0S.AS6: This file contains the source code 

used to create the BIOS for both the CPM.SYS and the 
LDRMB80.CMD The CP/M. STS BIOS is created with the ^ loader 
conditional assembly switch set to false. [Ref. 2 : p. 166] 

E. DKPRM.DEF: This file contains the hardware 

configuration tables for arranging up to 16 M3B-30 bubble 
memory devices or Intel MBS double density disic drive 
systems in any combination. It was used by Hiciclin and 
Neufeld in their Implementation of a "table driven’* BIOS. 
However, different I/O devices (i.e. RSMEX Data Warehouse] 
may not be added to their table. [Ref. 2 : p.95] 

F. CONFIO.DEF: Contained in this file are tne disic 

definition statements used by Hiciclin and Neufield to 
generate the Disk Definition Tables for their BIOS. The 
file generated is labeled C0NPI0.LI3 and is included into 
MBBI0S.A86 when assembled. [Ref. 2 : p. 92] and [Ref. 6 : 
p. 67] 

II. REMEX DATA WAREHOUSE FILES 

A. CPMBI0S.A86; This file is the basic table driven 
BIOS used in this thesis. By setting the MASTSR/SLAYS 
conditional assembly switch to either true or false, two 
different CPM.STS's can be created. The only difference in 
the two is that the CPMMA3T.CMD system contains code to 
initialize the synchronization and login variables located 
in common memory. The resulting MASTER file should be 
renamed to CPM.STS and placea on the bubble memory storage 
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device. Entering the comana GFFD4:4 from the tSiC 66/12A 
computer labeled #1 will hoot the system. 

When the MASTSR/SLAVE conditional assembly switch is 
set to false, a slave system will be created. This system 
should be named CPM3LAVE.CMD. It is this file that is 
eventually loaded into common memory via the command 
LDCPM.CMD. 

After the slave system has been loaded into common 
memory, the command LDBOOT.CMD must also be executed in 
order to place the loader program into common memory. Once 
these two commands have been executed, all other computers 
can issue the command GE000:400 to tne computer monitor and 
the CP/M operating system will be loaded for each. 

B. CPMMAST.CFG: This file contains the label tables 

for the seven I/O device-specific functions which are 
extracted out of the BIOS. These functions are INIT, 
3ELDSK, BOMB, 3ELTRK, 3EL3EC, SETDMA, and 3ETDMAB. A 
conditional assembly switch is located in the INIT table. 
When the master switch is set to true, two extra labels are 
included which permit the initialization of the 

synchronization and login variables in common memory. 

C. MB80DSS.A86: Located in this file is the code 

necessary to read and write to the MBB-60 Bubbl-Board . It is 
assembled into the CPMBI0S.A86 file by an "include” 
statememt . 



96 



D. RXFL0P.A86; Tills file contains the code for 
reading and writing to the RE^tEX Data Warehouse's two floppy 
disk drives. It is assembled into the CPM3I0S.A86 file by 
the use of an ’’include" statement. Command packets for the 
REMEX are built in common memory and all DMA is accomplished 
through common memory. 

The file labeled RXFLOPl .A86 is almost identical to 
RXPL0P.A86. The difference is that common memory is not 
used for DMA or packet building. Instead the REMEX directly 
accesses the host's on board memory. Thus RXFLOPl .A56 will 
only work for a computer which has its local memory address 
space between 0O000h and 0FFFFh. To permit additional 
computers to use this code, the packet addresses built in 
this BIOS will have to be changed to correspond to the 
computer's memory address space within the system's 
addressable memory space of 1 Megaoyte. 

E. RXEARD.A86: This file contains the code necessary 
to access the Eemex Data Warehouse's Winchester hard disk. 
It also contains the blocjcing and deblocking code required 
for mapping the REMEX's 512 byte sectors to CP/M's 128 byte 
logical sectors. It is assembled into the CPMBIOS .A66 file 
by an "include" statement. Command packets for the REMEX 
are built in common memory and all DMA is accomplished 
through common memory. 

The file RXHARD1.A86 is almost identical to RXEARD.A66. 
The difference being that common memory is not used for DMA 
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or pacicet building. See RXFL0P.A66 for more aetail, as 
changing RXEARD1.A86 to accomodate more than one user 
requires the same changes as RXFL0P1.AS6. 

F. CPMMAST.DEF; This file contains the CP/M-66 dislc 
definition statments used in this thesis. It is the source 
file for 5ENDEF.CMD which produces the file CPMMAST.LI3. 

0. CPMMAST.LIB: This file is assembled into tne 
CPMBIOS . Ao6 via an "include" statement. It contains the Disic 
Parameter Tables created by the CP/M utility program 
CENDEx.CMD, using the file CPMMAST.DEF as the input file. 

a. INTELDSK.A66: While this file is not included in 
the final hardware implementation of this thesis, it 
contains the code necessary for accessing the Intel MDS 
single density disic drive system. It was used extensively 
in the early developmental phases of this thesis because it 
provided an easy method of booting a new CPM.3YS. If this 
file is included into the CPMBIOS, the CP/M-56 operating 
system can be booted by issuing the command G-FFD4:43 to tne 
monitor . 

1. LDCPM.A36: This program must be executed in order 
to load CPMSLA7E.CMD into common memory beginning at 
I0ee :500. 



J. LDB00T.AS6: This program must be run before the 
slave CP/M system can be loaded by the other computers. 
When executed, the program BOOT.CMD will be placed in common 
memory beginning at E000:400. 
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K. BOOT.CMD: This is the loader program used by all 

but the initial computer to boot the CPMSLAVE operating 
system from common memory. It is executed by entering the 
command GE000:400 from the monitor after the programs 
LDCPM.CMD and LDBOOT.CMD have been run. 

L. RXEORMAT .AS6 : When an I/O device is first 

initialized for use under the CP/M operating system, the 
hex code E5's must be written on the trades which will 
contain the directory, otherwise the error "NO DIRECTORT 
space" will occur. This program will write S5's on the 
necessary trades for each head of the Winchester hard disle. 
Since executing this program will erase all files accessible 
to the different heads, it will prompt the user for 
permission to procede in order to insure that tne files are 
not erased by mistake. Normally this program will not be of 
any use unless a new hard disk is installed or a directory 
track is inadvertently destroyed. 

M. RXMAINT.A66: The REMSX Data Warehouse contains 

numerous built-in error checking and maintenance programs 
which can be implemented by building and then sending 
maintenance packets to the REMEX. This program prompts the 
user to choose one of these built-in maintenance programs 
and then runs the test. If an error is encountered, tne 
error-code is printed. The meanings of the error codes can 
be found in the REMEX technical manual. [Ref. 9 : p. 3-19] 

N. LCTtIN.ASS: This file contains the code necessary to 
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provide protection from more than one user logging on to the 
same area of the hard disk or the M3B-S2 board at the same 
time . 

0. SYNC.A 06 : This file must be included in the BIOS 
when more than one computer is going to operate on the 
Multibus. It contains the code which prevents more than one 
computer from accessing shared resources while another is 
conducting a read or write operation through common memory. 
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APPENDIX B 

PROGRAM LISTING OF CPMBI0S.A86 



Prog Name 

Modified 

Date 

Written by 
For 

Advi sor 
Purpose 



CPMBI0S.A86 (Master/Slave CPM Bios) 
Inclusion of Synchronization Routine 
7 October 1982 

Tom V. Almquist and David S. Stevens 
Thesis (AEGIS Modeling Group) 

Professor Kodres 

This BIOS is for use with the iSB66/12A. 
It requires a separate "include" file for 
each different I/O device. 



EQUATES 

^ }|c 3^ ^ 9^ 9*,: >;o!c # ^ ^ ^ 34c ^ ^ ^ ^ ^ ^ lit # >ic 



true 


equ 


-1 


false 


equ 


not true 


cr 


equ 


0dh 


If 


equ 


0ah 


error 


equ 


0ffh 


mas ter 


equ 


true 


;system addresses 




bdos_ int 


equ 


224 


ccp_of f set 


equ 


0300h 


bdos_of f set 


equ 


0B06h 


bios_of fset 


equ 


2500h 


;console via 


the i8251 USART 


cstat 


equ 


0dah 


c d a t a 


equ 


0d8h 


tbemslc 


equ 


1 


rdamsk 


equ 


2 



,‘carriage return 
;iine feed 

;general error indication 
»set for master/slave BIOS 



preserved BDOS interrupt 
Jstart of CCP code 
;BD0S entry point 
»start of BIOS code 



;status port 
;data port 

;transmit buffer empty 
;receive data available 



c seg 

org ccpoffset 

ccp : 

org bios_offset 






bios : 



;JUM? VECTORS 



J ^2 3*j2 5jS 3g« Sjt 5jS #yC2|C SjJ ^2 3|2 5ji 5|2 3{2 5jS 3(2 3(2 3(2 3c ^5* 5c ^c 5(2 3(2 3^ 3j2 3(2 3(2 3(2 3(2 3(2 3|2 3(23(2 3(2 3(2 3(2 3jf« 



jmp INIT 



JSnter from BOOT ROM or LOADER 



jmp WBOOT 
jmp CONST 
jmp CONIN 
jmp CCNOUT 
jmp LISTOUT 
jmp PUNCH 
jmp READER 
jmp HOME 
jmp SELDSK 
jmp 3ETTRK 
jmp SETSEC 
jmp SETDMA 
jmp READ 
jmp WRITE 
jmp LISTST 
jmp SECTRAN 
jmp SSTDMAB 
jmp GETSEGT 
jmp GETI03F 
jmp SETIOBE 



,‘Arrlve here from EBOS call C 
Jreturn console Reyl)oard status 
; return console keyboard char 
»* write char to console device 
;write character to list device 
Jwrite character to punch device 
;return char from reader device 
Jmove to trk 00 on sel drive 
;select disk for next rd/write 
Jset track for next rd/write 
; se t sector for next rd/write 
Jset offset for user huff (DMA) 
;read a 123 byte sector 
Jwrite a 126 byte sector 
;return list status 
;ilate lo, 2 ‘ical->physical sector 
;set seg oase for buff (DMA) 
;return offset of Mem Desc Table 
Jreturn I/O map byte (iobyte) 
Jset I/O map byte (iobyte) 



; Entry Point Routines 

include login. aSo Jnecessary for multi-users 



INIT: ;print slf^non message and initialize hardware 



5 cllld 


software 




mov 


ax , cs 


;we entered with a JMPF 


mo V 


ss, ax 


» so use cs: as initial 


mov 


ds,ax 


; segment values 


mov 


es , ax 




mo V 


sp, offset stkbase 


;use local stack 


mov 


i 0 by t e , 0 


; clear iobyte 


push 


d s 




uush 


es 




cld 




Jset interrupt 0 vector to 


mov 


ax , 3 


; address trap routine 


mov 


ds , ax 




mo v 


es, ax 




mo V 


intO_off St .offset 


int _ t rap 


mov 


into segment, cs 




mov 


di ,4 ; 


propagate to remaining vectors 


mov 


si , 0 




mov 


cx , 510 




mo vs 


ax, ax 




mo V 


bdi 0 , bdos_of f set 


;correct bdos int vector 


pop 


es 
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WBCOT ; 



CONST 



coni 



:ONIN 



poo 


ds 






call 


con_ini t 




Jinitialize console 


xo r 


bx , bi 




;get mass storage 


, • 

mo V 


ax , intbl [bx] 


; initlization table 


or 


ax, ai 




;quit if end of table 


Jz 


ini2 






push 


l3X 






call 


ax 




Jcall init entry 


pop 


bx 






inc 


bx 




;step to next entry 


inc 


bx 






Jmp 

) • 


inil 




jloop for next 


call 


1 ogin 






mo V 


bx , of f set 


sifnon 


{print sign on msg 


call 


pmsg 






mo V 


cl ♦ user 




{default to a: on coldstart 


Ji^P 


ccp 




{jump to cold entry of CC? 




; enter 


CC? at 


command level 


jmp 


ccp-f6 








; return 


console status 


in 


al , cstat 






and 


al , rdamsk 






j z 


coni 






0 r 


al ,0ffh 




{return non-zero if rda 


ret 










Jget a 


character from console 


call 


CONST 






jz 


CONIN 




{wait for RDA 


in 


al , cdata 






and 


al ,7fh 




{read data & remove parity bit 



r et 



> — 

CONCUT: ; send a character to console 



in al,cstat 

and al.themsk ;get console status 
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• 


jz 

mov 

out 

ret 


CON OUT 
al , cl 

cdata,al ;xmit buff is empty 

tthen return data 

# 


LIS TOUT 


• 

• 


» send character to list device 
»not yet implemented 


• ^ 


ret 




PUfJCE: 


ret 


Jwrite cnaracter to punch device 
;not implemented 


• 






READER : 




Jget character from reader device 
;not implemented 




mov 

ret 


al,lah ; return eof 


HOME; 

• 

f 




;move selected disk to t rs 00 
one of seven device specific functions 




mo V 

xor 

mov 

add 

call 

ret 


t rac£ , 0 
bi , bx 

bl.unit »get offset to actual device 

bx,bx 

hmtblLbx] Jcall" device code via tables 



SELDSK: »one of seven device specific functions 

^return pointer to appropriate 'disk 
;parameter block' (zero for bad unit no) 
JNOTS'- nunits is defined in tne .cfg file 



mov 


uni t , cl 


Jsave unit 


number 




mov 


bx,0000h 


;ready for 


error return 


cmp 

jnb 


cl , nuni t s 
sell 


;return if 


beyond max 


uni t 


mov 

add 


bl , uni t 
bx , bx 


;get offset 


to actual 


device 


call 
xo r 


dsktbl [bxl 
bx , bx 


;call device code via 


tables 
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mov 


bl , uni t 


;bx = 


cl * 16 








mov 


cl ,4 












shl 


bx , cl 












mo V 


cx, offset 


dpbase ;bx + 


= &dpbase 








add 


bx , cx 










sell 


. : . 












• ... 


ret 












f 

S3TTRK: 




Jset track address 








• 

9 




one of 


seven device 


specific 


functions 




mov 


track, cl 












xo r 


bx, bx 












mov 


bl , uni t 


Jget 


offset to 


device 






add 


b X , bx 












call 


t rk tbl [bx] 


Jcall 


device code via 


tables 


• 


ret 












9 

SETSEC : 




; set sector number 








• 

9 




one of 


seven device 


specific 


functions 




mov 


sector , CL 












xor 


bx, bx 












mov 


bl ,uni t 


.•get 


offset to 


device 






add 


bx , bx 












call 


sectbl [bx] 


J c a 1 1 


device code via 


tables 



ret 



SETDMA: jset DMA offset given by cz 

mov dma_adr,cx 
ret 



READ: Jread selected unit, track, sector to dma addr 

Jread and write operate by an indirect call 
; through the appropriate taole contained in 
; the configuration file. It is the programrrers 
; responsibility to ensure that the entry points 
;in these tables match the unit type 

xor bx,bi 
mov bl,unit 
add bx , bx 

call rdtbl[bxj Jcall device code via tables 

ret 
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WRITE: Jwrite from dma address to selected 

Junit, traclr, sector 

lor bi,dx 
mov bl,unit 
add bi.bx 

call wrtblLbx] Jcall device code via tables 

ret 



LISTST: ;poll list device status 

;not implemented 



or al,0ffh ;return ready anyway or 

ret ; system may bang up 



SSCTRAN: Jtranslate sector cx by table at Ldi] 

;N0TE: this routine is not adequate for 

; the case of >= 256 sectors per tracic 
Jstill it's better than DR's which is not 
Jadequate for the no table case either 



mo V 


ch , 0 






mov 


bx, cx 






cmp 


dx , 0 


{checK for no table case 


Je 


sel 






add 


bx , dx 


{add 


sector to table addr 


mov 


bl , [bx] 


{ get 


logical sector 


ret 









SETDMAB : Jset DMA segment given by cx 



mov dma_seg,cx 
r et 



(JETSEGT: Jreturn addr of physical memory table 



mov bx, offset segtable 
ret 



GETI03F: {return iobyte value 

{note - this function and 5ETI0EF 
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Jare OK but to impiement the function 
» the character 10 entry point routines 
;must be inodified to redirect 10 
^depending on the value of iobyte 

mov al, iobyte 
ret 



• - „ 

> 

SETIOBF: Jset iobyte value 

mov iobyte, cl 
ret 



SUBSOUTINSS 






> — — — 

int_trap: Jinterrupt trap - non interrupt 

Jdriven system so should never get 
Jhere - send mesage and halt 



con init 



pmsg : 



c li 




'Jblock interrupts 


mov 


ai,cs 




mov 


ds, ax 


;get our data segment 


mov 


bi, offset int_trp 




call 


pmsg 




hit 




; hards top 



; jinitialize console driver 

Jactually done by the iS3CS6/12a monitor 

ret 





;send a message 


to the console 




mov 


al , [bx] 


;get next char from 


message 


test 


al ,al 






jz 


pmsl 


;if zero return 




mov 


cl , al 






call 


CONOUT 


Jprint it 




inc 


bx 






Jmps 


pmsg 


Jnexi character and 


loop 



10 7 






mn.ssf' 





pmsl : 
ret 



3;c 3 ;^ sj5 sjc sjc ^5jc s;c 5 ;: :5c j;s aj: :{c ❖ 3CC s{c jjs :;s :Jc 5*: s;: 5^ 5|< 5^c 5{: 5*: 5{: ?;c 5>: :{? j{: :.•? :;c >;c 5jc 3}c 3&: ^ 

DISK SPECIFIC FUNCTION LABEL TABLES 

# s? # sjt si' # s;^ ijt s? # # # # Sjs 5? # Ji* >r J!s ❖ ’i' -r 5? >!« ❖ 5 {e ^ J|c # s;: # # # j;c j;t s"^ s’/ # s;: j!c 5 ); :it # s^c j;! s;; j;{ :^s ^ j? j|t 5 ^ 



JThe included .cfg file below maps unit number to disi 
Jdevice type. It provides tables of entry point 
Jaddresses for use by init, seldsk, seltrk selsec, home, 
tread and write. These addresses must appear in the 
t'appropriate include file for the particular device type 

include cpmmast .cfg Jread in label tables 



:}c :5c ajc :5c ajc a;c s;c Sic :}c a;c :|c :;c a;c 3 ,‘e :{c :;c 



ajc :|c 5|c ajc a|c >{ca;c ajc a;s ajc a*,c 



yU WU 

#1^ ^4% >1% 



:5c alc^gCiJc a*,: 



DISK INCLUDE FILES 

a;ca}c>;e:;:a;ca5c3{:ajc a;s ajt ajc a^ Jj: ajc a^c a}: a;? aleajcajcajc a;; a;c ale aj: a;< a? ajca;::,^ :5s a|t :;<ajs:{c:;sajs:jc:;s:;s:5c:jc:jeajsa;c 



ajs :;s :}f :;s a',s a;c :*< ajs ajc 



;For each I/O device to be accessed by the operating 
tsystem a separate file must be included. Within each file 
tseven functions must be addressed and are the same ones 
Jmentioned in CPf^MAST .CFG . The labels used to access these 
Jfunctions must be properly order in CPMMAST. CFG. 



include mb60dsk.aS6 
include riflop.aSS 
include rxhard.a86 



;MBB-£b bubble memory 
; REM EX flonyy disks 
JREMEX hard disk 



ajtai::;s3js:5e3;sajca5sajsa;sa;saj:a;sa;<3jca;sa;s3jsa;sa;ca;s:5sa;sa;<:;:a;ca;c>;<:;sa|saica;ta;ca:c:;c:5c:isa;s:jsa;sa;c:*ca5:a;sais:;s:;sa;s3;sa;s :;c:;c a;c:;s :;c:{sa;s 

RESOURCE ALLOCATION 



;Low-level synchronization of access to the shared 
idevice. <sync.a86> must include the entry 
Jpoints defined in the cfg. files. These are 
Jcalled on initialization and before and after 
faccessing the resource respectively. 

include sync .aS6 



aj? aj» ajs 35^ : 5 * ^ aje : 5 ^ ajc aj( 35^ ajc :js ajc a^ ajc ajs # 5 * 35^ 35^ a^ aj? a^s aji a^t ajc aje a^ aj^ 35* ajs a{« :J> aje a^c :{c a|t ajC 3 ji ajs a{c 35c ajc 3 |C a|^ ajs a 



DATA & LOCAL STACK AREA 



a{$ a{» 35^ 35c 3|t 3fS a^ a^ ajc a^c ajs ajc ajc ajc ajd aj* ajc ajt 3|/» 3y« ajs 35c a|s a^ a{2 aJjS 35 ^ ajs ajc a5« ajc aj% ajs ajc ai? a^x aj% ajc ajt ajc aje a5« ajs ajt a^t a(% 35^ a5* aj* a*,c ajc ajc a{c ajs ajt a^ ajc 



c seg $ 



signon 



db cr,lf,cr,lf 

db cr.lf.lf,' 

if master 
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, * 









i nt_trp 



i obyte 
uni t 
trade 
&ec tor 
drT’a_adr 
dma_seg 
loc_5 tic 
stkbase 



db 'CPM/S6 Master ' 

endif 

if not master 
db 'CPM/66 Slave ' 



endif 

db 

db 

db 

db 

db 

db 

db 

db 

db 

db 

r b 

rb 

rb 

r b 

r w 

rw 

r w 

eu u 



cr,lf,lf,' -Modified " 

6 October 1982 by' 

cr,lf,lf,' Tom V. Almquist 

and David S. S tevens ' , cr ,lf ,lf 

For use with a Pubble Memory and 
'the P-SMEX Dataware House' 
cr, If ,0 
cr , If 

'Interrupt Trap Halt' 
c r , 1 f , 0 

1 Jcharacter i/o redirection byte 

1 jselected unit 

1 jselected track 

1 ;selected sector 

1 Jselected DMA address 

1 jselected DMA segment 

32 Jlocal stack for initialization 

offset $ 



Jsystem memory segment table 



seg table 



db 1 

dw tpa_seg 
dw tpa_len 
dw 2000E 
dw 200eH 



J1 segment 

Jlst seg starts after BIOS 
Jand extends to t'op of T?A 



V' ^ 

#]• #fS ^1* 0 ^ • 



^ 'V 

^ ^ ^ ^ ^ ^ ^ ^ n* ^ ^ ^ 'i‘> 



DISK DEFINITION TABLES 






JThe included .lib file contains disk definition 
Jtables detailing disk characteristics for the bdos 
J .lib files are generated by OSNDEF from definition 
Jfiles and must comply with the allocations made in 
Jthe corresponding configuration file. (Lable Tables) 



include cpmmast .lib Jread in disk def tables 



wy «ju vv ^ vv oy %v vy ^ ^ ^ ^ Vf 

5^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ 



END OF BIOS 



f sjt :js 5): sjs V sje :!« v Sr Jis sit 5? J!5 sy Sr >r -r S' -r 5)! SI* -r nS 



lastoff equ 
tpa_seg equ 
tpa_len equ 



offset $ 

{ 1 a St of f -^0400h->-l 5 ) / 16 
1000h - tpa_seg 
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LSj,:- s 




; PAGE ZERO template 

j Sicsic ;i<3$C9(i:3iC3icX( 3^3t:3ic#3ic3ic #3r :(< >r ^ >K :i(:r 





dseg 


0 


Jabsolute low memory 




org 


0 


{(interrupt vectors; 


int0_of f s t 


rw 


1 




int 0_segmen t 


rw 


1 






rw 


2*{bdos 


int-i ) 


bdio 


rw 


1 


;bdos interrupt offset 


bdis 


rw 


1 


Jbdos interrupt segment 



end 
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APPENDIX C 

PROGRAM LISTING OP CPMMAST.CFG 



IProg Name 
;Da te 

JWritten by 
;?o r 

; Advisor 
; Purpose 



CPMMAST.CFG ( Master Configuration for CPM ) 

13 September 1982 

Ton V. Almquist and David S. Stevens 
Tnesis (AEGIS Modeling Group) 

Professor Sodres 

This code is an include file w/ln CPMBI03.AS6. 
It contains the device tables for access to 
initialization, read, & write routines. 



; DEFINE nunits 

nunits do 7 ; total number of mass storage units 



INITIALIZATION TA3LS 

intbl contains a sequence of addresses of initialization 
entry points to be called by the« BIOS on entry after 



;a cold boot. The sequence is 

intbl dw offset mb80dsic_init 
dw offset riflop_init 
if master 

dw offset initsync 
dw offset init_login 

endif 

dw 0 



terminated by a zero entry 

; ini tial ize Bubble 
; ini tial ize Remex 

Jinitialize sync variables 
; initial ize login 
; procedures 
,‘end of table 



; READ TABLE 

Jrdtbl and wrtbl are sequences of length nunits, containing 
;the addresses of the read and write entry point routines 
» respec ti vely which apply to the unit number corresponding 
Jto the position in the sequence. These and the entry pts 
jfor initialization must correspond to those contained in 
; the appropriate include files containing code specific 
;to the devices. 

rdtbl dw offset mb80dsh_read ,* A : is a bubble memory 

dw offset rxflop_read JB: is Remex floppy disk l 

dw offset rxflop.read ;C: is Remex floppy diSiC 2 
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dw offset rxhard_read 
dw offset rxhard_read 
dw offset rxiiard_read 
dw offset rihard'read 



D: is Remex hard disic 0 
3: is Remex hard disl-c 1 
?: is Remex hard disk 2 
G is Remex hard disk 3 



; WRITE TABLE 



wrt bl 



dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 



mb80d si_wri te 
rxf lop_writ e 
rxf lop_write 
rxhard_write 
rxhard_write 
rxhard’wr it a 
rxnard_ write 



HOME TABLE 



hmt bl 



dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
d w offset 
dw offset 



mb80dsk_home 
rxf lop_home 
rxf lop_home 
rxhard_home 
rxaarl_home 
rxhard_ home 
rxhard home 



; SSLDSK TABLE 

dsktbl dw offset mb80d SK_seldsk 
dw offset rxf lop. seidsk 
dw offset rxf lop_seldsk 
dw offset rxharl.seldsk 
dw offset rxhard_seldsk 
dw offset rxhard_seldsk 
dw offset rxhard seldsk 



; SETTRK TABLE 

trktbl dw offset mbe0dSiC_set trk 
dw offset rxf lop_settrk 
dw offset rxf lop_settrk 
dw offset rxhard. set t rk 
dw offset rxhard.settrk 
dw offset rxh ard _ se t t rk 
dw offset rxhard settrk 
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J 

t 

sectbl 



SSTSSC TABLE 

dw offset mb80dslt_setsec 
dw offset rxf lop.setsec 
dw offset rxf lop_setsec 
dw offset rxliard^setsec 
dw offset rxaard_ setsec 
dw offset rxhard_setsec 
dw offset rxhard setsec 
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APPENDIX D 

PROGHAM LISTING OF MSe0rSK.A86 



Prog Name 
Date 

Modified "by 
For 

Advisor 

Purpose 



MB60DSKA66 (BUBBLE MSMORT DISK) 

24 Aug 1962 

Tom V. Almquist and David S. Stevens 
Thesis (AEGIS Modeling Group) 

Professor Sodres 

This code is an include file w/in CPMBI0S.AS6 
It contains the code necessary to access the 
bubble memory as a dis5 drive. 



EQUATES 



Miscellaneous equates 



mb^contbase 
addr_high_ ram 
bdos_int_ type 
sector size 



equ 8000H 
equ 0f00H 
equ 224 
equ 128 



Jcontroller base 
Jhigh para user avail RAM 
;reserved BDOS interrupt 
;C?/M logical dsi£ sector size 



Magnetic bubble characteristics (MBB-SD) 



mb_buf 1 en 
mb_maxdevs 
mb_maxpages 
mb_maxsec tors 
mb_pages_sec 
mb_pagesl ze 
mb shew 



equ 144 
equ 7 
equ 641 
equ 60 
equ 3 
equ 18 
equ 12 



Jbuffer length for MBB sector 
; bubble devices are g0-»7 
trf of pages on each device 
»# of log. sectors on each dev 
of pages per logical sector 
Jbubble device page size 
;shew factor for page xlation 



»■ Magnetic bubble command bytes and masks (M33-S0'' 



mb_chKbusy_cmd 
mb_chKint_mask 
mb_inhint_cmd 
mb_init_cmd 
mb_mpage_ cmd 
rob_read_cmd 
mb_reset_ cmd 
mb_wr ite_cmd 

CSEG $ 



equ 020E 
equ 080E 
equ 080H 
equ eiE 
equ 010H 
equ 012H 
equ 040E 
equ 014H 



;is controller busy ? status 
Jmash to chic for M3E interupt 
;interrupt inhibi t /reset mash 
Jinitialize the controller 
Jmulti-page mode operation cmd 
Jmulti-page read command 
Jreset the controller 
Jmulti-page write command 
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CEVICS SPICIEIC ACCESS CODS 

•-T+ + + - 



-+-r 



;initialize bubble ;called from INIT 

jparm in - none 
;parm out - none 



mb80dsk_in it : 

push es 
init_mbb80 : 

mov ax,mb_contbase Icontroller base 

mov es.ax Jaddress to es veg 

mov ax,mb_maxpages »??s per bubble dev 

mov es:mbp_loopsize_lo ,al 
mov es:mbp_lcopsize_hi ,AS 
mov es;mbp_pgsize_reg,mb_pagesize 



; issue reset command to the controller 



mov al ,mb_reset_cmd ;reset masic byte 

mov es :mbp_cmnd_reg ,al ;issue reset cmd 



; initialize each bubble device 



push cx 

mov cx,mb_maxdevs-rl 
mo V ai , 0 



jsave cx, outer counter 
; count for loop-rr of devs 
jdevice ff to initialize 



For _each : 

mov es:mbi) select bub.al ; select each device 



mov es :mbp_cmnd_ reg ,mb 
push axipush cx Ipush es 
call mbbee_wait 
pop es! pop cx ! pop ax 
inc al 
loop for_each 
pop cx 
pop es 
Device_ret : 
ret 



init_cmd Jinit device 
Jsave bub#, counter ,es 
;wait for controller 
,‘reset es , enter , f^3B# 
;next device number 
idee cx, loop not zero 
;reset cx , outer enter 
;restore register 



JHOME BUBBLE » called via home table 

mb80dsic_home: 

xor cx,cx »set tracic to zero 

call SettrlE 

ret 
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SELECT BUBBLE DISK 


; called 


via 


seldsic 


table 


mb80dsk_seldsis:: 
r et 


»no special 


action 


requi red 


SELECT BUBBLE TRACK 


; called 


via 


seltrx 


table 


mb80dslc_settrlr: 

call mbb60_ tracic_i lat 










ret 










SET 3UBLE SECTOR 


J Cd 1 1 6d 


vi a 


setsec 


ta ole 


mb80dsic_set sec : 
ret 


;no special 


action 


required 



;MBB60_READ called via read table 

; reads a sector from bubble 
Jparm in - none 

Jparm out - status of the op in al. 
; 00= OK, FF= unsuccessful 



mb80dsk_r ead ; 

call request 
push es 

call mbb80_ sect or_ila t 
mov ax ,mb_cont base 
mov es,ax 
mov 
mov 
mov 
mov 



Jget resource (STMC.A86) 
Jsave register 
^compute 1st page** of sect 
Jaddr of controller base 
;ioad es to address buoole 
;multipase cmd 
; current page number 
Jpage select lo byte 
,'page select hi byte 



es:mbp_cmnd_reg ,mb_mpage_ cmd 
ax ,mb_page_no 
es:mbp_pagesel_lo ,al 
es :rabp_pagesel_hi ,AH 



>set number of pages to transfer = pages/sector 



mov es :mbp_pagecnt _lo ,mb_pages_sec ;#pages xfer 
mov es:mop_pagecnt_hi ,0 ;hi oyte of # is 0 

jset up dma address to receive data 



mov cx,mb_buflen 
push ds 

mov ax,dma_seg 
push ax 



Jcount for loop-buffer size 
?save C?/M's ds 
Jset dma segment 
;save dma segment ds 



116 



mov bi,dmd_ddr 



Joffset of dmd dred 



; select bubble device end issue redd corrmdnd 
mov dl,mb_bub_no Jcurrent bubble number 

pop ds ;iocdl, redddr dmd ared 

mov es ;mbp_select„bub ,dl Jselect current dev a 
mov es :mbp_cmnd_reg ,mb_read_cmd Jread from FIFO 

Read_int : 

mov a 1 , es; mbp_i nt _f lag »’get interrupt status 
and al ,mb_cnicrnt_mask , ‘interrupt set ? 

jz Read_int ;if zero, keep checking 

tread enough from bubble sector to fill dma area? 

cmp cx, (mb_buf len - sector_size) jxfer enough? 
jnz Read_one ; if not, read another byte 

pop ds ^restore CP/M's ds 

mov bx, offset mb_overflow ;reset dest to ovrflow 

t’read from MSB FIFO buffer into dma area 



mov al , es :mbp_rdata_re 

mov [bx] , al 

inc bx 

loop Read_int 

push es 

call Mbb80_Wait 
pop e s 

mov es:mbp_cmnd_reg,mb 
mov a 1,0 
push ax 
call release 
pop ax 
pop es 
ret 



Jread a byte into accum 
;ioad accum into dma area 
Jincrement index 
;dec cx , loop if not zero 
;save es fo-r call 
;wait for controller 
;restore es after call 
inhint_cmd ;clear int 
;indicate no error 
Jsave status of read 
Jfree resource (STNC.ASc) 
;restore registers 



;MEBe0_WRITF called via write table 

writes a sector to bubble 
;pariT: in - none 

Jparm out - status of the op in al 
;00 = OK, FF = unsuccessful 



mb80dsk_write: 

mov al , 0 
cmp al.user 
jnz mbwrt_err 
call request 
push es 



jbubble logical drive 
»‘is user logged in on mb80 

;get resource (STNC.AcG^ 
;save register 
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call M^b80_Sect or_Ilat Jget 1st page# of sector 
mov ax ,m>)_cont base Jaddress of controller base 

mov es,ax Jloai es to address bubble 

mov es:mbp_crnnd_reg,.nb_iiipage_cmd;multpg mode cmd 
mov ax , mb_page.no Jcurrent page number 

mov es :mbp_pagesel_lo ,al ipage select lo byte 

mov es:mbp_pagesel_hi ,AH Jpage select hi byte 

;set number of pages to transfer = pages/sector 



mov es:mbp_pagecnt_lo ,mb_pages_sec ;#pages to ifer 
mov es :mbp_pagecnt _hi ,0 Jhi byte of # is zero 



Jset up dma address for transfer 



mov cx,mb_buf len-1 
push ds 

mov ax,dma_seg 
push ax 

mov bx,dma_adr 



Jcount for loop-write 
;save CP/M's ds 
;get dma segment 
; save dma segment ds 
Jaddress of dma area 



; select bubble device and issue write cmd 



mov al,mb_bub_no 

mov es:mbp_sel ect_bub ,al 

pop ds 

mov al , [bx] 

mov es :mbp_wdata_reg ,al 
inc bx 

mov es :mbp_cmnd_reg , mb_w 



{current bubble number 
{select current dev # 

{ readd r dma a rea 
{load first byte 
{write byte to MBS buff 
{ increment index 
te_cmd{send write to MBS 



{wait for interrupt from controller 
Write_ int : 

mov al ,es:mbp_int_flag {get interrupt status 

and al ,mb_ chici nt.mask {interrupt set ? 

jz Write_int {if zero, keep checicing 

{write into MSB FIFO buffer from dma area 



mo V 

mo V 

inc 

loop 

pop 

push 

call 

pop 

mov 

mov 

push 

call 



, [bx] {byte from dna to al 

;mbp_wdata_reg ,al {write byte to MBS buff 
{increment index 

Lte_int {dec cx , loop if not zero 

{restore CP/M's ds 
{save es for call 

b83_'j^ait {wait for controller 

{restore es after call 
mbp_cmnd_reg ,mb_inhin t_cmd{ clear cont int 
^ {return success code 

{save success code 
{free resource (STNC.AS6) 



,0 
.ease 
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,*restore register 



pop ax 
pop es 
jmp mbwrt_ret 
mbwrt_err: 

mov bi, offset mbwrt_[nsg 
call pmsg 

mov al,0ffh ;error returned to CP/>! 

mbwrt_ret : 
re t 



;++*H 



-+++•*-- 






BUBBLE SUBROUTINES 






•- + -T+-- 



; MBB80_SECTOR_XLAT called from; Mbb80„Read, Mbb62_Write. 

Jcomputes 1st page^ for a given sector 
»on a single chip. Based on S3 sectors 
;on each chip - sector = 128 bytes. 
Jparm in - none, works on sector 
Jparm out - none, updates ir'b_page_no 



Mbb60_ 


Sector 


_Xlat: 






10 r 


ai ,ax 


;set ax to 0 to hold page# 




lor 


cx , cx 


Jclear cx for counter 




mov 


CL , Sector 


?ctr for translation loop 




xor 


DX,DX 


; clear DX 




mov 


DL ,mb_sect or 


Jsect# for 1st sect on trk 




add 


cx , DX 


Jadd 1st sect;? to log sect# 




dec 


CL 


; sub tract 1 for the loop 


Add 


jz 

skew: 


M bb80_sx_exit 


Jsect 1 is page 0, no xlat 




add 
c Ic 


ax ,mb_ skew 


;add skew between pages 
Jclear carry 




s bb 


ax,mb_maxpages 


;mod to # of pages 




jae 


Dec_sect or 


;jump if positive (CF=0) 




add 


ax,mb_.maxpages 


Jwent (-), add back #pages 


Dec 


sector: 






loop 


Add_skew 


;dec sector#, add skew again 


Mbb60_sx_ 


exit: 






mov 


mb_page_no ,ai 


Jstore page number 



M3B60_TRACK_XLAT called from: SETTRK. 

; computes bubble ft from track ft. Gets 
j'first bubble sector (1-S0) for that 
;track for later conversion to page ft. 
Jparm in - none, works on track. 

; prm out - loads mb_buo_no ,mb_sector 
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MbbS0_Tra clc_Xla t : 

xoT bx,bi ;clear bx for add 

mov EL, tract ,'load track - index 

add 3L,3L Jdouble track# for index 

mov ax ,mb_track_table [bx] ?get word from table 
mov mb_bub_no,AH Jlow byte = bubb device# 

mov mb_sector,al jtiigh byte = 1st sector# 

re t 



;MBB60_WAIT called from; HbbS0_Init, Mbb80_Read, 

;Mbb80_‘*'rite. 

Jchecks status of MBE cont for busy 
;keeps cbecking (wait) until not busy 
Jparm in - none 
;parm out - none 



Mbb80_Vait: 

mov ax ,mb_cont base Jaddress of cont base 

mov es,ax ;ioad es to addr bubble 

See_zero : 

mov al , es ;mbp_status_reg jget status register 
and al ,mb_cbkbusy_cmd Jis it all zeros ? 
jz See_zero Jif so, keep checicing 

Cont_busy ; 

mov al ,es ;mbp_status_reg Jget status register 
and al ,mb_chi£busy_cmd ;see if busy, and to mask 
jnz Cont_busy ;if busy, check again 

ret 



+ + -r- 






DATA SEGMENT AREA 



■f +-r-+ + -f~- 



•-r-t* f -r 4“ — + -*~ 



*r + + -r-r-J--h 



irbwrt _msg 

mb_bub_no 
mb_overflow 
mb_page_no 
mb sector 



— Bubble Variables 

db cr, If, 'Write Access Not Permited' 

db ' On This Drive. ',0 

rb 1 ;bubble device number 0-7 

rb (Mb_buflen - sector_size) ;read overflw 

rw 1 ;bubble page number 

rb 1 ;bubble sector number (1-80) 



»Sach entry in the track table corresponds to one of the 
;24 tracks on the M3B-S0. The 1st byte in each entry is the 
;bubble number; the 2nd byte in each entry is the starting 
isector number for that track on that bubble device. 
mb_ track_ table dw 0000H,201aH,0034H, 0100H , Ollan ,0134H 
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• 


dw 

dw 

dw 


esEG 

# 


f 

irbp_pagesel_lo 


rb 


mbp_pagesel_iii 


rb 


mbp_cmnd_ reg 


rb 


mbp_rdata_ reg 


rb 


mbp_wdata_reg 


rb 


mbp_status_reg 


rb 


mbp_pagecn t_lo 


rb 


mbp_pagecnt_hi 


rb 


mbp_ioops i z e_l 0 


rb 


mbp_loops ize_hi 


rb 


J'il>P_PSSize_reg 


rw 

rb 


mbp_selec t_bub 


rw 

rb 


mbp_int_f lag 


equ 



3200H,021aH,0234H,03iJ0H ,031aE .0334H 
040eH, 041aE,0434H, 0500E, 051aE ,0534E 
0600B,061aH,0634H,07J0B,071aB ,0734H 



1 ;is "byte for page select, (0) 

1 ;n)s 2 bits for page select, {1) 

1 Jcommand register, (2) 

1 ;read data register, (3) 

1 Jwrite data register, (4) 

1 Jstatus register, (5) 

1 ;is byte for page counter, (6) 

1 ;ms 2 bits for page counter, (7) 

1 jls byte for minor loop size,^5' 

1 Jms 2 bits for min ^oop size, (9) 

1 Jinternal use(page pos , , (A.B) 

1 Jpage size register, {C^ 

1 ;TI use only, (D,3) 

1 ;two uses: select bubble dev (J) 

mbp_select_bub Jinterrupt flag (7) 



/ 
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APPENDIX E 

PROdRAM LISTING OP RXFL0P.A86 



Pro^ Name 
Da te 

Written Ly 
For 

Advisor 

Purpose 



RXFL0P.A86 (aEMEX FLOPPT DISK 

ACCESS CODE) 

9 October 1982 

Tom V. Almquist and David S. Stevens 
Thesis (AEGIS Modeling Group) 

Professor Kodres 

This code is an include file w/in CPM3I03.A86. 
It contains tne code necessary to access the 
Remex floppy disk drives. I/O done through 
common memory. Tnis configuration is set for 
CP/M logical drives 1 (B;) and 2 (C:). To 
alter, change code in READ and WRITS routines. 



;++++++++++++++++++++ Equates +++++++++ + -r++++++++-!-+-+-+++-+ 
; Disk Controller command bytes and masks (RSMEX) 



dk_rdy_mask 

dk_rd_cmdl 

dk_rd_ cmd2 

dk_wr_cmdl 

dk_wr_cmd2 

tries 

dr ive2 



equ OSH 

equ 1011H Jread command 

equ 1012E 

equ 1021H ;write command 

equ 1022H 
equ 10 
equ 2 



;CPM logical dsk # for 
Jdrive 2 



REMEX Interface Controller Ports 



cmd_ reg 
status_reg 
p_addr_lo 
p_addr_hi 



equ 70H 
equ 713 
equ 72H 
equ 73H 



Jctrler's base in CP/M-S6 



+-^* +++ + + •r + -!--^• + -!■ + ++-^ + + -+ -^ + H K+ •^+-h + + + ++ + -(- + l--r+-^ + i--“ + -‘ (-- + T++- + + 

CPM DEVICE SPECIFIC CODE 
entered via label tables in CPMMAST.CFG 



+++- 



• +++■ 



+ + + + - + ++++ + *++-i-+-)- + + ++ + + + + + + + + i-+++4--i--r + 



cseg $ 



rxf lop_in it : 
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ret 



;no special action required 



rif lop_home: 

ret > no special action required 



rxf lop_seldsls:: 

ret ;no special action required 



rxf lop_settrk: 

ret ;no special action required 



rxf lop_setsec : 

ret >*no special action required 



rxf lop_read: 





mo V 


rwdi r , 0 




call 


request 




cmp 


uni t ,drive2 




jz 


rdl 




mo V 


bx,dk_rd_cmdl 




jmps 


rd2 


rdl ; 




mo V 


bx,dk rd cmd2 


rd2 : 




call 


build_packet 




call 


send_packet 




call 


xf r_buf f er 




call 


rel ease 




mo V 
ret 


al , result 



;^et resource (STNC.A66) 
;C?/M logical disk No. for 
JRemex floppy drive 2 (C:) 
Jset up to read drive i (I:) 



Jset up to read drive 2 



;perform the read 
;xfr C?M buffer into Tenory 
;free resource (STNC.Ac6) 
jreturn success/failure code 



rxf lop_wr i te : 



mo V 


rwdi r, 1 


call 


request 


cmp 


uni t ,drive2 


Jz 


wrt 1 



,* request ticket number 
;CP/M logical disk No. for 
JRemex floppy drive 2 (C:) 
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il-fr 




mov 


hx, dk_wr_cmdl 


jmps 


wrt2 


wr tl : 




mov 


bx , dk_wr_cmd2 


wr t2 : 




call 


build_packet 


call 


xf r_buf fer 


call 


send_packe t 


call 


release 


mo V 


al , result 


ret 





;setup write to drive 1 (B : ) 
-Jset up to write drive 2 

Jfree resource (STNC.AE6) 

» return success/f ailure code 



; + + f + + + + + + + - + + + + + + + + + + + + + + + 

; HEMEX FLOPPY DISK SUBROUTINES 

bui ld_pacicet ; 



push 


es 


Jsave es register 


mov 


ax, cmemseg 


;set up es to address common 


mov 


es , ax 


Jmemory S000: 


mov 


p_modif ier s ,bx 


Jenter read code in packet 


mov 


p_status ,0 


;dear packet status word 


mov 


ax , 0000E 


Jclear register 


mov 


al , track 


;get track ^ 


mov 


p_track_no ,ax 


;enter track # in packet 


mov 


ax , 0000H 


jset head no. to £ 


add 


al , sector 


;set sector no. 


mov 


p_head_sect ,ax 


;put head S, sec U in packet 


mo V 


p_mem_adar ,0100h 


Jaddress of CPM buffer 


mov 


p_msb , 000eh 


; C?M buffer msb 


mov 


p_word_count ,64 


of 16 bi t words 


pop 


es 




ret 







f 

send_packet : 



push es 

mov ax,cmemseg 

mov es,ax 



;common memory segement = S000 



mov 


dk 


_ cnt , 


tri 


es ; 


load CO 


unt for 


ret ries 


in 


al 


, stat 


us_ 


reg 








and 


al 


, dk 


rdy 


_mask 


; check 


interf a 


ce ready 


cmp 


al 


,08S 






;is it 


ready ? 




jne 


sendl 






; if no 


t ready 


repeat 


mov 


al 


, IcH 












out 


cmd_reg 


fSl 




; load 


ex tended 


address 


mov 


ax 


, 0004n 




; packe 


t offset 




out 


p_ 


addr_ 


lo , 


al 


; tran s 


fer low 


byte out 


mov 


al 


, ah 
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out 


p_add r_hi ,a 1 


Jtransfer hi byte out 




check_r esul t : 








mo V 


ax , p_status 


;ioad status word 




cmp 


ax , 0001H 


Jcheck for success 




Je 


success_read 






cmp 


ax , 0000H 


Jcheck for failure 




jne 


re try 






Jmps 


checkresult 






retry : 








mo V 


dk_err_code ,al 


Jsave error code 




mov 


ax , 0 


Jclear status word 




dec 


dk_cnt 


{reduce retry count 




jnz 


send_packe t 


{if <> 0 try again 




mov 


resul t , 0?FH 


{return failure 


code 


Jmps 


dk_execute_ret 






success_ read : 






mo V 


re sul t , 00H 


{ return success 


code 


dk_execute_ 


ret : 






pop 


es 







ret 



xfr buffer: 



push 
mo V 
mo V 
mo V 
mo V 
mo V 
mov 
cmp 

J2 

xchg 
mo V 
mo V 
mo V 

xfr : 

cld 
r ep 
pop 
re t 



es ! push ds 
es,dma_seg 
di ,dma_adr 
ax, cmemseg 
ds, ax 
si ,0100h 
cx,64 
rwdi r , 2 
xfr 
si , di 
ax , ds 
e s, ax 

ds , dma_seg 



movs ax, ax 
ds ! pop es 



Jget data from common memory 
Jand load into local memory 



set up for write operation 



Jmove as 16-bit words 



; Data Area 

; ++•i-++++•+T•r-♦•-^++++-r + + + -^•+++ + -t■-^--r +++-T +++-!- + + + +++ + + •r + ■^ + + + -r+t +-*--r-f-r 

; Remex Interface Packet 

Jpacket located in common memory at E000:£004 

eseg 
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p_inodlf iers 
p~s ta tus 
p_t rack_no 
p_head_sect 
p_mem_addr 
p_rnsb 

p_word_couRt 



dk_err_code 
di:_ciit 
result 
rwd i r 



org 0004h Joffset of packet 



rw 1 
rw 1 
rw 1 
rw 1 
rw 1 
rw 1 
rw 1 



^function S. logical unit 
Jreturned status 
Jselected track number 
iselected head/sector number 
;buffer address 

{extended bits of buffer address 
{size of data block 



Misc Variables 



cseg $ 

db 00H {returned Hemex error code 
db 00E 
rb 1 

rb 1 {0 = read { 1 = write 
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APPENDIX I 

PROGRAM LISTING OP RXHARD.A86 



Prog Name 
Date 

Modified 
Written by 
For 

Advisor 

Purpose 



HXHAHD2.A66 (EEMEX HARD DISK ACCESS CODE) 

13 October 1982 

Transfer Thru Common Memory /Ticket Sync 
Tom 7. Almquist and David 3. Stevens 
Thesis (AEGIS Modeling Group) 

Professor Kodres 

This code is an Include file w/in CPMSI03.AS6. 
It contains the code necessary to access the 
REMEX hard disk drive. 



Equates 

Disk Controller command bytes and masks (REMEX) 



hdi:_rdy_mask 


equ 08H 




hdK_rd_cmd 


equ 1313H 


Jread command 


hdk_wr_cmd 


equ 1020E 


Jwrite comm.and 


hdk_tr ies 


equ 10 




headO 


equ 3 


;CP/M logical dsk# for head 
>0 of REMEX hard disk 


pstrf 


equ 9 


;print string function 



• 

> 


REMEX 


Interface 


Controller Ports ~ 


hdk 

hdk, 

hdk 

hdk 


_CMD_r eg 
_s tatus_reg 
_addr_lo 
_addr_hi 


equ 70H 
equ 71E 
equ 72H 
equ 73H 


;c trier's base in CP/M-86 



• 

» 




“B1 ockin^/Deblocxcing 


una 


equ 


byte ptr 


[3X] ;name for byte at 3X 


blks i 2 


equ 


16384 


;CP/M allocation size 


hstsiz 


equ 


512 


;host disk sector size 


hstspt 


equ 


39 


;nost disk sectors/trk 


hstblk 


equ 


hstsiz/128 ;CP/M sects/host buff 


secshf 


equ 


2 


; log2 (hs tblk ) 


cpmspt 


equ 


hstblk * 


hstspt ;CP/M sec tors /t rac£ 


secmsk 


equ 


hstblk-1 


;sector mask 


wra 11 


equ 


3 


Jwrite to allocated 


wrd ir 


equ 


1 


Jwrite to directory 


wrual 


equ 


2 


jwrite to unallocated 
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+ + ++ + + + + + + + ++ + ++ + + + + + + + ++-f + +-r+ + + -t- + + + + + + + ++ + + + + + + + ++ + -r + + -^ + + + 

DIVIC2 SPSCiriC CODS 

entered from the main CPMBIOS via label tables 

+ + ++ + +-1-+ + + + + + + + + + + ++ + +-r+ + -r++T + + + + + -!--r + + + -l- + + + ++-*■ + + + + + + T + + + + + + 



CSEG $ 



; INIT 




;called 


from INIT 


rihard_ 


init: 






• 


ret 






f 

;homs 




entered 


via home label table 


Rxhard 


home : 








mo V 


al , hstwrt 


{check for pending write 




test 


al , al 






jnz 


homed 






mo V 


hstact ,£■ 


{clear host active flag 


homed : 






• 


ret 






JSELECT 


DISK 


entered 


via seldsk laoel table 


Rxhard_ 


seldsic: 








mov 


cl , uni t 






mo V 


sehdsh, cl 






test 


dl , 1 


{1st activation of disk? 




jnz 


contl 


{no 




mov 


hs tac t , 0 


{ yes 




mov 


unacnt ,0 




con 


tl : 






• 


ret 






IsELECT 


TRACK 


enterd via seltrk label table 


Hxhard_ 


se ttrh: 








mov 


sek t rk , cx 






ret 






IsELECT 


SECTOR 


entered 


via selsec laoel table 


Rxhard_ 


setsec : 








mov 


seksec , cl 






ret 
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Irsad 



entered via read label table 



Rihard^read: 
mo V 


unacnt , 0 


;read selected CP/M sector 
rclear unallocated counter 


mo V 


readop , 1 


Jread operation 


mo V 


rsf lag,l 


Jmust read data 


mo V 


wrtype ,wrual 


»treat as unalloc 


Jtnp 


rwoper 


;to perform the read 



;WRITR 



enter via write label table 



wr i te : 




;write selected C?/M sector 


mo V 


readop , £■ 


;write operation 


mo V 


wrtype , cl 




cmp 


cl , wrua 1 


; write unallocated? 


jnz 


chkuna 


Jcheck for unalloc 




fWrite to 


unallocated, set parameters 


mo V 


unacnt , ( bl 


ksiz/128) j'neit unalloc recs 


mo V 


al , sekdsk 


Jdisk to seek 


mo V 


unadsk , al 


Junadsk = sekdsk 


mo V 


ax, sekt rlc 




mo V 


unatrk , ax 


lunatrk = sektrk 


mo V 


al , seksec 




mo V 


unasec , al 


Junasec = seksec 



-f'4- 



BLOCKING & DEBLOCKING SUBROUTINES 



Chkuna : 


; check for write 


to un all oca 


ted secto 


mo V 


bx, offset unacnt 


; point "una" 


at UNACN 


mo V 


al , uaa 






test 


al , al 


jany unalloc 


remain? 


jz 


all oc 


Jskip if not 




Jmore unallocated records remain 






dec 


al 


; unacnt = un 


acnt-1 


mo V 


una , al 






mo V 


al , sekdsk 


;same disk? 




mo V 


bx , of f se t unadsk 






cmp 


al , una 


; sekdsk = un 


adsk? 


jnz 


alloc 


Jskip if not 






; disks are the same 




mo V 


AX, unatrk 






cmp 


AX, sektrk 






jnz 


al 1 oc 


Jskip if not 






f tracks are t he 


same 
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mo V 


al , sehsec 


Jsame sector? 




mo V 


bx, offset unasec 


Jpoint una at unasec 




emp 


al , una 


; seksec = unasec? 




jnz 


alloc 


;skip if not 


; match, 


move 


to next sector for 


future ref 




inc 


una 


Junasec = unasec+1 




mo V 


al,una 


jend of track? 




emp 


al , cpmspt 


;count C?/M sectors 




jb 


noovf 


Jskip if below 


Joverflow to 


next trade 






mo V 


una , 0 


; unasec = 0 




inc 


unat ric 


; una trk=una t rk+1 


noo vf : 


;match found, marie as unnecessary read 




mo V 


rsfla^,0 


Jrsfldg = 0 




jmps 


rwoper 


; to perform the write 


alloc : 


,*not an unallocated record, requires pre- 




mo V 


unaent , 0 


;unacnt = 0 




mo V 


rsflag ,1 


; rsflag = 1 








Jdrop through to rwoper 


; Common 


code 


for READ and WRITE 


follows 


rwoper : 


Jenter here to perform the read/write 




mov 


erflag,0 


;no errors (yet) 




mo V 


al , seicsec 


jeompute host sector 




s ub 


al , 1 






mo V 


cl, seeshf 






shr 


al , cl 






mov 


selehst , al 


Jhost sector to seek 


; ac tive 


host 


sector? 






mo V 


al , 1 






xchg 


al ,hstact 


, ‘always becomes 1 




test 


al , al 


;was it already? 




jz 


filhst 


;fill host if not 


;host buffer 


active, same as seek buffer? 




mo V 


al , sekdsk 






emp 


al ,hstdsle 


; sekdsk = hstdsk? 




jn2 


nomatch 








; same disk, same 


track? 




mov 


ax ,hst t rk 






emp 


ax , sekt rk 


,‘host trk same as seek 




jnz 


nomatch 





;same disi, same trade, same buffer? 
mo V al , sekhst 
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crrp 


al , hs t sec 


♦'sekhst = h St sec? 


Jz 


match 


;skip if match 


nomatch: 


;proper disk. 


but not correct sector 


mo V 


al , hstwrt 


t est 


al , al 


; dirty ^buffer ? 


jz 


filhst 


;no, don't need to write 


call 


wri tehst 


♦yes, clear host buff 


f ilhs t : 


♦may have to 


fill the host buffer 


mo V 


al , sekdsk 


! mov hstdsk,al 


mo V 


ax, sekt rk 


I mov hsttrk,ax 


mo V 


al , sekn St 


! mov hstsec,al 


mo V 


al , rsf Id^ 




t est 


al , al 


Jneed to read? 


Jz 


f i 1 h s 1 1 




call 


readhst 




f ilhstl: 


mo V 


hstwrt , 0 


Jno pending write 


match : 


; copy 


data to or from 


buffer depending on readop 


mo V 


al , seksec 


Jmask buffer number 


sub 


al , 1 




and 


ax , secmsk 


;ieast signif bits masked 


mo V 


cl ,7 


Jsnift Isft 7 


shl 


ax , cl 


;(- 12c = Z^'^7) 


has relative cost buffer 


offset 


add 


ax, offset hstbuf ;ax has buffer address 


mo V 


si ,ai 


'♦put in source index reg 


mo V 


di,dma adr 


♦user buff is dest if readop 


push 


DS 


'' 


push 


ES 


Jsave segment registers 


mo V 


SS , dma_se? 


'♦set destseg to the user seg 
;SI/DI and DS /SS is swapped 
; if write op 


- mov 


cx, 128/2 


Jlength of move in words 


mo V 


al , read op 




test 


al , al 


;which way? 


jnz 


rwmove 


;skip if read 




♦write operation, mark and switch direction 


mo V 


hstwrt , 1 


Jnstwrt = 1 (dirty buffer ) 


ichp 


si ,di 


Jsource/dest index swap 


mov 


ax, DS 




mov 


ES , ax 




mov 


DS, dma_se^ 


Jsetup DS,ES for write 



rwmo ve : 
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Jmove as 16 oil words 



c Id 



mo vs 


AX, AX 


pop 


ES 


pop 


DS 




Jdata has 


cmp 


wrtype , wn 


mov 


al , erf lag 


jnz 


return_rw 




; clear ho 


test 


al , al 


jnz 


re turn_rw 


mov 


hstwrt ,0 


call 


wri tehst 


mov 


al , erf lag 



iresiore segment registers 



r Jwrite type to directory? 
Jin case of errors 
;no further processing 

; clear host buffer for directory write 

; errors? 

Jskip if so 
Jbuffer written 



return_rw; 

ret 



read hst; 



mov 


hdk_rwdi r ,0 




call 


request 


Jget resource (SY^JC.AS6) 


mov 


bx,hdic_rd_cmd 




call 


hdic_bui ld_packet 




call 


hdiC_ send_packet 


Jperform the read 


call 


hdk_if r_buf fer 




call 


release 


Jfree resource (STNC,A66) 


mov 

ret 


al ,ndk_result 


Jret success/failure code 



write hs t ; 



mov 


hdk_rwdir ,1 






mov 


al ,hst_dsk 






cmp 


al .user 






jnz 


wrt_err 






call 


request 


;get 


resource (STNC.A36) 


mov 


bx ,hdk_wr_cmd 


; set 


up write to hard disk 


call 


hdk_bui ld_pac ket 






call 


hdk_if r_buf fer 






call 


hdk_ send_ packet 






call 


release 


; free 


resource (STNC.A56) 


mov 


al ,hdk_result 


;ret 


success/failure code 


jmp 


wr t_ret 






wrt_er r : 








mo V 


bx, offset wrtmsg 






call 


pmsg 
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mov al,0ffh ;retura error to C?/M 

wr t_r et : 
ret 



; +++ + + + + + + + + + + -*- + + + + + + -r + + + + -t-<- + + + + + + + + -r + + + -r++-t- + + + + + -r + -^+ t+ + + + -p-t 

; REMEX RARD DISK SUBROUTINES 

J ++ -r + + ++++ + + -r + + -*- + + + + + + + -t + + -►++ + + + + -I-4-+ + + + + +++ + + T + + ++ + + + + + + + -*•+ + 

hdic_'build_pacicet : Jpacket built in common memory 



push 


es . 




no V 


ax , crTiemseg 




no V 


es , ax 




no V 


hdk_modif iers .ox 


Jenter read code in packet 


mov 


hdi status, 0003H 


; cl ear packet status word 


no V 


AX,0000E 


Jclear register 


mov 


ax ,hst_trk 


;get track no. 


mov 


hdk track no ,AX 


Jenter tracK no. in packet 


mov 


AZ,0000H 


;dear register 


mov 


ah ,hst_dsk 




5 uh 


ah , head 0 


Jdetermine head # 


mov 


AL ,hs t_sec 


;set sector # 


add 


ax , 1 




mov 


hdk head_sect ,AX 


;ioad in packet 


mo V 


hdk mem addr,0100h Jaddress of C?/M buffer 


mov 


hdk_msb , gOEeh 


; common memory seg 


mov 


hdk_word_cnt ,256 


]>* of 16 bit words 


pop 


es 




ret 







) — 

hd£_send_packet : 



push 


es 




mov 


ax , cmemseg 




mov 


es,ax 




mov 


hdk cnt ,hdk trie 


s ;ioad count for retries 


nd_hdk_packe t ; 




in 


AL,ndk status_reg 


and 


AL.hdk rdy mask 


Jcheck interface ready 


cmp 


AL,06H~ 


;is it ready? 


Jne 


send_hdk_packet 


;if not ready repeat 


mov 


al , Ich 




out 


hdk_cmd_ reg ,AL 


;ioad extended address 


mo V 


ax , 0004h 




out 


hdk addr lo,AL 


;transfer low byte out 


mo V 


AL,AH 




out 


ndk_addr_ni ,AL 


;transfer hi byte out 


:heck_hdk_ 


resul t : 




mov 


ax,ndk status 


;ioad status word 


cmp 


AX, 0001H- 


Jcheck for success 
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Je 


hdk_success_read 




cmp 


AX,0000H {check for failure 




Jne 


hdk_ret ry 




jmps 


check_hdk_result 




hdlc_r etry : 






"mov 


hdk err code.AL {save error code 




mov 


hdk_status,0 {clear status word 


dec 


hdk_cnt {reduce retry count 




Jnz 


send_hdk_packet {if <> 0 try again 




mov 


hdk_result ,0FIH {return failure 


code 


jmps 


hdk_execute_ret 




hdR_success_ 


read : 




mo V 


hdk_result ,00H {return success 


code 


hdk_execute_ 


ret : 




pop 


es 




ret 







hdJc xfr t)Uffer: 



,‘transfer data from common 
{memory to local memory 



push es ! pusn ds 

mov ax,cs 

mov es.ai 

mov di, offset hstbuf 
mov ax.cmemseg 

mov ds,ax 

mov si,0100h 

mov cx,256 

cmp hdt_ rwdi r , 0 

jz bdk_xfr 

xchg si,di 

mov ax,ds 

mov es,ax 

mov ax,cs 

mov ds,ax 

hdlr_xf r : 
cld 

rep movs ax, ax 

pop ds ! pop es 

ret 

; Data Segment Area 

I + + + + + + + + + -r+ + -^4* + + + + + 

; Remex Interface Pacicet 

{pacxet built in common memory at 3300:0004 

eseg 

org 0004h {offset of pacicet 
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hdlE_mod if iers 

hd)£_status 

hdJc_t raclc_no 

hdk_head_sec t 

Qdlc_mem_addr 

hdk_ms5 

hdk_word_cnt 

• 


rw 1 
rw i 
rw 1 
rw 1 
rw 1 
rw 1 
rw 1 

cseg $ 


Jfunction & logical unit 
;returned status 
;selected track number 
^selected head/sector number 
Jbuffer address 

Jeitended bits of buffer address 
;size of data block 










varidDics ^ 


hdic err 


code 


db 


02H 


; returned Remei error code 


hdk cnt 




db 


30H 




hdk_resi! 




rb 


1 


; success/ fai lure code 


nd£_ rwd ir 


rb 


1 




seic dsk 


r b 


1 




;seek disk number 


sek_tric 


rw 


1 




;seej£ track number 


sek_sec 


r b 


1 




Jseek sector number 


list _dsic 


rb 


1 




Jhost disk number 


hst_trk 


r w 


1 




Jhost tracic number 


hst_sec 


r b 


1 




;host sector number 


sek_list 


rb 


1 




j'seek shr secshf 


nst_act 


rb 


1 




Jhost active flag 


hst.wrt 


r t) 


1 




Jhost written flag 


una_cnt 


rb 


1 




Junalloc rec cnt 


una_dsk 


r b 


X 




Jiast unalloc disk 


una_trk 


r w 


1 




;iast uaalloc track 


una_s ec 


r b 


1 




;iast unalloc sector 


erf la^ 


r 0 


1 

X 




Jerrcr reporting 


rsf lag 


rb 


1 




; read sector flag 


readop 


rb 


1 




tl if read operation 


wrtype 


r b 


1 




;write operation type 


dma_of f 


rw 


1 




;iast dma offset 


hst b’jf 


r b 


hstsi z 


Jhost buffer 


wrtmsg 


db 


cr 


, If, 'Write Access Mot Permitted On This' 




db 




Drive ' ,0 
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APPENDIX G 

PROGRAM LISTING OF CPMMAST.DEF 
The following disls definition statements were used in 
this thesis. The command "GENDEF CPMMAST.DEF" is executed 
to produce CPMMAST.LIB which must he assembled into the BIOS 
using an "include" command, 
disks 7 

diskdef 0,1,26,0,1024,71,32,3,2 
d i skdef 1 , 1 , 26 ,6 , 1 024 ,243 .64,64,2 
d iskdef 2, 1 

diskdef 3,1,156 ,0,16384,275,128,0,1 

diskdef 4,3 

diskdef 5,3 

diskdef 6,3 

endef 
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APPENDIX H 

PRCG?.A^^' LISTING OF CPMMAST.LIP 



When GENDEF is executed using CP^MAST.DSF as the source 
file, CPMf^AST.LIE is created. The listing which follow is 
the code generated hy GENDEF and must be assembled into the 
BIOS with an ‘‘include’’ command. 



• 

J 




DISSS 7 


dpbase 


equ 


$ 


dpe0 


d w 


xlt0,0000h 




dw 


0000h ,0000h 




dw 


di rbuf ,dpb0 




d w 


CSV0 , al v0 


dpel 


dw 


xl t 1 , 0000h 




dw 


0000h , 0000h 




dw 


dirbuf ,dpbl 




d w 


csvl ,alvl 


dpe2 


dw 


xlt2,0000h 




d w 


0000h , 0000h 




d w 


di rbuf ,dpb2 




dw 


csv2, alv2 


dpe3 


dw 


xlt3,0000h 




d w 


0000h,0000h 




dw 


di rbuf , dpb3 




d w 


csv3,alv3 


dpek 


dw 


xl t4,0000h 




d w 


000 0h , 0000h 




d w 


dirbuf ,dpb4 




dw 


csv4,alv4 


dpeo 


dw 


xlt5, 0000h 




dw 


0000h , 3000h 




dw 


dirbuf ,dpb5 




d w 


csv5 ,alv5 


dpe6 


dw 


xlt6,0000h 




dw 


0000h , 0000h 




dw 


di rbuf , dpbb 




d w 


csv6 , alv6 


• 

y 




DISKDEF 0,1,26,0 


dpb0 


eq u 


offset $ 




dw 


26 




do 


3 




db 


7 



»3ase of Disk Parameter Blocis 

JTranslate Table 

;Scratch Area 

JDir Buff, Parm Block 

JCheck, Alloc Vectors 

JTranslate Table 

^Scratch Area 

;Dir Buff, Parm Block 

;Check, Alloc Vectors 

;Translate Taole 

JScratch Area 

;Dir Buff, Parm 31oc£ 

, 'Check, Alloc Vectors 
^Translate Table 
;Scratch Area 
;Dir Buff, Parm Block 
;Check, Alloc Vectors 
;Translate Table 
;Scratch Area 
;Dir Buff, Parm Block 
JCheck, Alloc Vectors 
^Translate Taole 
JScratch Area 
;Dir Buff, Parm Block 
;Check, Alloc Vectors 
JTranslate Table 
;Scratch Area 
JDir Buff, Parm Block 
JCheck, Alloc Vectors 
,1^24,71,32,0,2 
JDisk Parameter Block 
,'Sectors Per Track 
, 'Block Shift 
JBlock Mask 
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db 


0 




dw 


70 




dw 


31 




db 


128 




db 


0 




d w 


0 




dw 


2 


Xlt0 


equ 


offset $ 




db 


1 , 2 , 3 , 4 




db 


5, 6, 7, 8 




db 


9,10,11 ,12 




db 


13, 14,15,16 




db 


17, 18,19,20 




db 


21,22,23,24 




db 


25,26 


als0 


eqii 


9 


CSS0 


equ 


0 


• 

» 




DISSD2F 1,1 


apbl 


eq u 


offset ? 




dw 


26 




db 


3 




db 


7 




db 


0 




d w 


242 




, dw 


63 




db 


192 




db 


0 




dw 


16 




dw 


2 


xltl 


equ 


offset $ 




db 


1,7,13,19 




db 


25,5,11,17 




db 


23 ,3,9,15 




db 


21,2,8,14 




db 


20,26,6 ,12 




db 


18,24,4 ,10 




db 


16,22 


alsl 


equ 


31 


cssl 


equ 


16 


» 

f 




DISEDEF 2,1 


dpb2 


equ 


dpbl 


als2 


equ 


alsl 


CSS2 


equ 


cssl 


xlt2 


equ 


xltl 


« 

f 




DISKDEF 3,1 


dpbo 


equ 


of f se t $ 




dw 


156 




db 


7 




db 


127 




db 


7 




dw 


274 




d w 


127 



;Extnt Maslc 
;Disk: Size - 1 
^Directory Max 
; A11OC0 
;A11oc1 
JCheclc Size 
;0ffset 

JTranslate Table 



JAllocation Vector Size 

;Check Vector Size 

,1024,243,64,64,2 

;Dislc Parameter Block 

;Sectors Per Track 

;B1ock Shift 

; Block Mask 

jExtnt Mask 

;Cisk Size - 1 

^Directory Max 

; Alloc0 

JAllocl 

JCheck Size 

;Cffset 

^Translate Taale 



;Allocation Vector Size 
JCheck Vector Size 

JEquivalent Parameters 
;Same Allocation Vector Size 
;Same ChecKsum Vector Size 
;Same Translate Table 
0,16384,275,129,0,1 
JDisk Parameter Block 
Sedovs Per Track 
;Block Shift 
;Slook Mask 
;3xtnt Mask 
JDisk Size - 1 
;Directory Max 
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xlt3 



db 
db 
d w 
dw 
equ 
db 
db 
db 
db 
db 
db 
db 
db 
db 
dD 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
ab 
db 
db 
db 
db 
db 
ab 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

als3 equ 
css 3 equ 

dpb4 equ 
a Is 4 equ 

css 4 equ 
xlt4 equ 
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3 

3 

1 

offset $ 

1, 2,3,4 

5, 6 ,7 ,3 

9,10,11 ,12 

13, 14,15,16 

17,18 ,19,20 

21,22,23,24 

25,26,27,26 

29,30,31,32 

33 , 34 ,35 ,36 

37,38,39,40 

41,42,43,44 

45,46 ,47 ,46 

49,53,51,52 

53, 54 ,55 ,56 

57,56,59,60 

61,62,63,64 

65,66,67,68 

69,70,71,72 

73,74,75,76 

77,78 ,79,80 

61,82,83,84 

85,86,67,88 

89,90,91,92 

93,94,95,96 

97,98 ,99,100 

131 .132 ,133 ,134 
105,106 ,107 ,106 
139,110,111,112 
113,114 ,115 ,116 
117,118 ,119,120 
121,122,123,124 
125,126 ,127,128 

129.130 .131 .132 
133, 134,135,136 
137 ,138 ,139 ,143 
141,142,143,144 
145, 146 ,147 ,148 
149,150,151 ,152 
153,154 .155 ,156 
35 

3 

DISSDEF 4,3 

dpb3 

als3 

css3 

xl t3 

DISKDEF 5,3 



; A11OC0 
; Aiioci 
JCnecic Size 
;Offset 

;Translate Taole 



JAllocation Vector Size 
JCheclc Vector Size 

^Equivalent Parameters 
;Same Allocation Vector Size 
JSame Checksum Vector Size 
;Same Translate Table 
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dpbS 


equ 


dpb3 


als5 


equ 


als3 


css5 


equ 


c s s3 


iltc 


equ 


xlt3 


• 




BISKDIF 6,3 


dpo6 


equ 


dpb3 


"alse 


equ 


als3 


css6 


equ 


css3 


xlt 6 


equ 


xl t3 


• 

• 




ENDEF 


t 

• 

• 


Uninitialized Scratch 


f 

begda t 


equ 


offset $ 


dirbuf 


r s 


12S 


a Iv 0 


r 5 


al s0 


CSV0 


rs 


CSS0 


alvl 


rs 


alsl 


csvl 


r s 


cssl 


alv2 


r s 


als2 


csv2 


rs 


css2 


alv3 


rs 


als3 


csv3 


rs 


css3 


alv4 


r s 


al s4 


csv4 


rs 


css4 


alv5 


r 5 


als5 


csv5 


r s 


css5 


alv6 


rs 


also 


csv-6 


rs 


css6 


eudda t 


equ 


offset $ 


datsiz 


equ 


offset ^-beerd 




db 


0 



^Equivalent Parameters 
»3ame Allocation Vector Size 
;Same Checlcsuin Vector Size 
;Same Translate Table 

;Squivalent Parameters 
;Same Allocation Vector Size 
;Same Checlcsum Vector Size 
jSame Translate Table 



Memory Follows; 

JStart of Scratch Area 
JDirectory Buffer 
JAlloc Vector 
JChecic Vector 
JAlloc Vector 
;Checlc Vector 
; Alloc Vector 
;Checic Vector 
;a11oc Vector 
;Checlc Vector 
JAlloc Vector 
;Checi£ Vector 
jAlloc Vector 
;Check Vector 
JAlloc Vector 
JCheck Vector 
;Snd of Scratch Area 
iSize of Scratch Area 
JMarks End of Module 
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APPENDIX I 

PROGRAM LISTiNG"OF 1NTELDSK.AS6 



;?rog Name 
JDate 

;Written by 
JModified by 
JFor 

JAdvi sor 

; Purpose 
• 
s 

f 



INTELDSK.A66 (MD’S S. Density Floppy Routines) 

9 Aug 1982 

Jim John, SMC 1277, 649-0592 
Tom V. Almquist and David Stevens 
Thesis (AEGIS Modeling Group) 

Professor M.L. Cotton 

This code is an include file w/in CPMBI0S.AS6. 
It contains the routines for using the MDS 
Single Density Floppy Di sic . It is configured 
for a single iS GE 56/12A and does not use 
common memory for I/O. 



EQUATES 



Jport addresses 



bas e 


equ 


076h 


rr tport 


equ 


base+1 


rrbport 


equ 


base+3 


resport 


equ 


b a s e +7 


dstport 


equ 


base 


ialpor t 


equ 


base-^1 


iahport 


equ 


base->-2 



; command 


codes & masks 


rdc ode 


equ 


4 


wrc ode 


equ 


6 


cwc ode 


equ 


83H 


intbit 


equ 


04h 


retries 


equ 


13 



;iSBC201 port address base 
;read result type (input) 
Jread result byte (input) 
preset iSBC201 (output) 
Jread subsystem status 
; ( input ) 

, ‘write iopb addr low 
; (output ) 

Jwrite iopb addr nigh 
; (output ) 



jread command code 
Jwrite command code 
*, channel command code 
Jinterrupt bit masK 

Jfor di sic i/o, before error 






+ + + + + h-r- 

ENTRY POINT ROUTINES 



• -f- -r — — 4* + ' 






inteldslc_ ini t : Jinitialize lisJc controller 

Jactually done by 13BC86/12 monitor 

ret 
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9 “ 

inteldsk_home; 




ret 

• . . .. 




» 

inteldsk_seldsk : . 




ret 




9 

int eldsk_set trk : 




ret 

• 





9 



int eldsic^^setsec: 
re t 



» ___ 
inteldslc_read; > read sector from dislc 



mo V cl , 4 
mov al.unit 
sal al , cl 
or al , rdcode 
mov io_com,al 
call dsic_io 
ret 



;comDine disk selection 
;with opcode 

; to make io command for read 
;set it in comd word of iopb 
;and execute it 



inteldsk_write: Jwrite to disk 



mov cl , 4 
mov al.unit 
sal al,cl 
or al,wrcode 
mov io_com,al 
call dsk_io 
ret 



; create io command for write 



;go do it 



SU3R0UTIM3S 






dsk_io: ;execute disk read or write function for 

;iS3C201 controller. Sets up remainder of 
jiopb and sends its addr to the controller 
;then polls for a response and checks for 
; error condit ions . 

mov io_chw, cwcode Jset no wait code for channel 
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mo V 


io_nsc , 1 




mo V 


al , sector 




mo V 


io_sec, al 




mo V 


al , traci 




mo V 


io_ trt , al 




mo V 


cl , 4 




mo V 


ai,dma_seg 




Sdl 


ax , cl 




add 


ax , dma.adr 




mo V 


io_ adh , ah 




mo V 


io_adl , al 




mo V 


try_cnt , retries 


dio 1 : 


in 


al , rrtpo rt 




in 


al , rrbport 




mo V 


cl , 4 




mo V 


ax , cs 




sal 


ax , cl 




add 


ax, offset iopb 




out 


ialpor t , al 




mo V 


cl ,8 




sar 


ax , cl 




out 


iahpor t , al 


dio2: 


in 


al , dstport 




and 


al , intbi t 




J2 


dio2 




in - 


al , rr tport 




or 


al , al 




jz 


dio3 




in ^ 


al , rrbpo rt 




Jmps dio4 


dio3 : 


in 


al , rrbpo rt 




0 r 


al , al 




jz 


dio6 


dio4: 








dec 


try cnt 




jnz 


diol 




0 r 


al , error 


dio6: 


ret 






— -f -f -f 





PRIVATE DATA 



;transfer 1 sector 

;set up iopb trK and sect 



;recombine dma sag and addr 



Jset it in addr word of iopb 



fClear controller 
;get address of iopb 



;and send it out 



»wait for con trier interrupt 



;checic completion code 



; status ch(£rd, ignore result 
Jand retry 
;check io result 

;ret with al=3 if no error 
;error if we got here 
j'decmt count and try again 
;try again if any left 
Jset permanent error code 




cf J 









i opb 


rb 7 








;i/o parameter blocK 


i 0^ 


ch w 


equ 


iopb 






;iopb channel byte 




com 


equ 


iopb 


-f 


1 


; command byte 


io_ 


nsc 


equ 


iopb 


-r 


2 


, 'sectors to xfer (always 1; 




trk 


equ 


iopb 




3 


Jselected track 




sec 


equ 


iopb 


-f 


4 


Jselected sector 


io_ 


adl 


eq u 


iopb 




5 


Jphysical address for S3C201 


i o_ 


adh 


equ 


iopb 


+ 


6 




try 


cnt 


rb 1 








;disk error retry counter 



VO 
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APPENDIX J 

PROGRAM LfSTING“OF LDCPM.AS6 



Prog Name : 


LDCPM.A86 


- 


Written by : 


T.V. Almqulst 


and D. Stevens 




This program 


reads the file entitled 




CPMSLAVE .CMD 


into common memory beginning a 




location S000 


:500 . 


cseg 






org 


3100h 




jnip 


start 




^ sjc ^ sSc ^ ^ ^ ^ 


si: 3): 3^ s;: 3ic ^ sic 3}e sic 3^ 3i: sic 3|c s;: 3^ s;: 3}e 3 ;: s;; sjss;: 3 ;: 




Equates 


:^cs;::ie^3;();c3^3Sc 3jS2;:3;c3ie3^3;c 


cr 


equ 0dh 


;carriage return 


If 


equ 0ah 


;line feed 


dr ive 


equ 0334t 


Jtarget C?/M drive # 


bdos_int 


equ 224 


;interupt vector 


pstrf 


equ 9 


Jprint string function 


seldskf 


equ 14 


;select dislc function 


openf 


equ 15 


lopen file function 


readf 


equ 20 


Jread function 


dixaf 


equ 26 


»set drtia offset function 


dmabf 


equ 51 


;set dma base function 


sjc Jtc ;!: 5j8 5j: 5 ;: 5JS >;c si: Jfi 3[t 3}c >!C s;c 5{? s;s sjs i|s ?;c j:? :Jc 3;c >;s sjs ^ 3^c 


sjc 3}C sjc sjc sjs 3 ;: sjc Sic sjc Sic s Jc sjc sjs 5}C s;c s;s sjc Jjc s;s 5 ;: ;|c s,': >;c sj: >jc 




Subroutines 


3je 355 sjc 3jt 3}e sj: 5ie sjc »}; 3jc 3je sj: 


'T* *T“ 't^ *Tr* np <Tp 0* 'T* *T* *V* 'P 


^ ajolc >i$ 3 ^ :4c ,}c ,}( >;c ^ ^ ^ :js ^ SK ^ 


seldisk : 




Jselect target disic # 


mo V 


cl, seldsif 




mo V 


dx , drive 




jmp 


sys_vec 




openf nc : 




;open file denoted in fcb 


mo V 


cl , openf 




mov 


di, offset fcb 




jmp 


sy s_vec 
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t 



setdinab: 



Jset dma base address 



mo V 


cl , dmabf 




jmp 


sy s^vec 


• 


setdma : 




;set dma offset 


mo V 


cl , dmaf 




Jmp 


sys_vec 




read : 




; read 12£ bytes from file 
; in fcb 


mo V 


di, off set fcb 




mo V 


cl , readf 




Jmp 


sy s_vec 




msg : 




,‘print a character string 
Jend of string denoted by 0 


mo V 


cl , pstrf 




jmp 


sy s_vec 





sys_vec: Jeiecute bdos function call 



int bdos_int 

ret 

• ^ jJ: 5^: sjc ^ 5{c :Jc sjc s,*? ^ :{es;c3;ojc 3^ 

; Main Program 

• 3;c5;s5;?3;:i;s5;<3'ic5;<5;s5|c3;ssicy^i;«3;c5;«5;s;jcs}c5,'t5;::;c5ic:;c:;t5;c:4i:>>:5;c:4t3{:5;5 5js5jcs;c5;c3ic>;c;{s5j:>;cs;cs;;5jc3;«5;s5jc5jc5tc3;c5jc3js 3^3;:3;c;jC5i:5;c 

start : 



call 


seldisic 


;select desired disK 


call 


openf nc 


Jopen file 


cmp 

jne 


al ,255 
cont 


I* if fil e not f ound 


mo V 


di, offset 


nofile 


call 

Jmp 


msg 

stop 


Jprint error msg 


• 

# 

mo V 


# * 

di,cs 


Jsave 1st page in local 


call 


setdmab 


i memory 


mo V 


dx , offset 


pagel 


call 


setdma 




call 


read 


Jread 1st page 
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;read file into comrnom memory 



mo V 


dz , 0e000h 




;set dma base to common 


call 


setdmab 




; memory 


mo V 


dz, 3500h 




^desired offset 


readf ile : 








call 


setdma 






push 


dz 






call 


read 




Jread 126 byte page 


cmp 


al,01h 




»‘read complete ? 


i e 


done 






cmp 


al , 00h 




; repeat 


Je 


con t read 






mo V 


dz , offset 


rer r 


;otherwise print read er: 


call 


msg 






jnip 


stop 






con*tread : 








pop 


dz 






add 


dz,080h 




; increment dma offset fo] 


jmp 


readf i le 




Jnezt page 


done : 








mo V 


dz , offset 


f msg 


;print completion msg 


call 


msg 

0 






: 

mo V 


cl , 00h 




;return to CP/M 


mo V 


dl ,00h 






in t 


bdos_int 







»* Data 



nofile 


db 


cr, If , 'CPM3LAV2.CMD Not Found On This Dislc? ' 


rerr 


db 


cr ,lf , 'Read Srror$ ' 


fmsg 


db 


c r , If , ' CPMSLAVS . CMD Loaded into Common 




db 


'Memory^ ' 


fCt) 


do 


04, 'CPMSLAVS' , 'CMD ',0,0, 0,0, 0,0, 0,0, 0,0, 0,0 




db 


0,0, 0,0, 0,0, 0,0,0 


pagel 


rs 


12S 




db 

end 


0 
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appendix k 

PROGRAM LISTING OF LDB00T.A86 



;Prog Name 
^Written by 

I 

> 



LDB00T.A86 

T.V. Almquist and D. Stevens 

This program loads the boot loader into 

common memory and is used by slave c6/12As. 






V*^ %*« *** 



cseg 

org 01i30h 

jmp start 

s;e 3$( ^ b}e b;: ^ ^ ^ Sic ^ 3;^ ^ ^ ^ ^ ^ >«c nC ^ 3 ;: ^ ^ ^ ^ 3;^ ^ ^ ^ 9;^ 3n 3;c ^ s;: 

Bqua tes 

:j: :{: sjc :{« 5{c a{c ^ 55 c 5ic >Jc 5JC Sic sjc 5jc 5ic ;{c Sic jjc 3jc ??: sic :jc 5 ;: 3{c j;c sic sic Sic s;c ajc s;c Sic sjc 5ic 5{c ;{c Sic Si: 3jc >;: -c Sic Sic >ic s;c sj: 3ic 3 ;: sjc s;s 5{c 5jc 5 ;: Sic 



cr 


equ 


Mh 


;carriage return 


If 


equ 


0a h 


;iine feed 


dr ive 


equ 


0004h 


jtarget CP/M drive # 


bdos_in t 


equ 


224 


Jinterupt vector 


ps trf 


equ 


g 


;print string function 


seldskf 


eq □ 


14 


Sselect disk function 


openf 


equ 


15 


;open file function 


readf 


equ 


20 


Jread function 


dmaf 


equ 


26 


; set dma offset function 


dmabf 


equ 


51 


Sset dma base function 



• sic sic sic sic sic 3 }: sic sic sic sj: sic si: sjcsic sic s|c sic sic sic sic sic sic si: sic sic sic sic si: sic sic si: sic sic sics;;: Sic sic sic sic sic sic si: sic sic si; sic si; sic sic sic si; sic sic si: sic: 

; Subroutines 

j sicsiesicsiesjjsicsicsicsicsicsics^^siesicsicsicsicsicsicsiesicsicsicsicsicsxsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsicsic 



3jC3iC 



seldisi: 



Jselect target disk # 



mo V 


cl , seldskf 


mo V 


di , drive 


jr^P 


sys_vec 



penf nc ; 




mo V 


cl , openf 


mov 


di, offset fcb 




sy s_vec 



open file denoted in fob 



> 
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setdmab 



;set dma base address 



mov cl.dmabf 

jmp sys_vec 



> 






setdma ; 




>*set dma offset 


mov 


cl ,dmaf 




jmp 


sys_vec 




» 

read ; 




Jread 12S bytes from file 
;in fcb 


JIO V 


dx, offset fcb 




mov 


cl , readf 




• 


sy s__vec 

• 




r ' 

msf : 




Jprint a character string 
;end of string denoted by 0 


mo V 


cl , pstrf 




jmp 

• 


sy s^vec 




» 

sys_vec : 




; execute bdos function call 


in t 


bdos_ int 




ret 






# 


a}: :J: :5c ;Je 5|s :^c ^ 5{s :;c -c :Jt 5is :js :;c 5j: ^ >;« s;? :{c s;c 5jc j;c 5^: sjs 5is :;c :js 3{s :js >;i 5? 5^ 


• 

> 


Main Program 






V# %V %V V# %•# V# V? ^ ^ 

#1^ ^1% >1% #1^ ^1^ #1^ #1^ #1^ #1^ #g« ^1% #1^ 


sta rt : 






call 


seldisk 


Jselect desired disi 


call 


openf nc 


Jopen file 


cmp 


al,255 


; if fil e not found 


jne 


con t 




mov 


dx, offset nofile 




call 


msg 


Jprint error msg 


jnip 


stop 




c ont : 






mo V 


di , cs 


j'save 1st page in local 


call 


setdmao 


Jmemory 


mo V 


dx, offset pagel 




call 


setdma 




call 


read 


Jread 1st page 
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; read file into commotn memory 



mo V 
call 
mo V 

r eadf lie : 
call 
push 
call 
cmp 
je' 
cmp 
je 

mo V 

call 

jmp 

contr ead ; 
pop 
add 
Jmp 

done : 
mo V 
call 

stop: 

mo V 
mo V 
in t 



dx , 0e000h 

setdmab 

dx,0400h 



setdma 

dx 

read 

al ,01h 

done 

al ,00h 

contread 

dx, offset rerr 

msg 

stop 



dx 

dx,080h 
readf ile 



dx, offset fmsg 
msg 



cl , 00h 
dl,00h 
hdos int 



Jset dma base to common 
; memory 

;desired offset 



Jread 12S byte page 
; read complete ? 

> repeat 

;otherwise print read error 



;increment dma offset for 
;next page 



;print completion msg 



; return to CP/M 



; Data 



^ «v 

<nr 'r* *ir ^ 'T* 



y.tsJC3?:?5,t3;£ 



nofile 


do 


cr, If , ' BOOT .CMD Not Pound On This Disk$' 


rerr 


db 


cr, If, 'Head Srror^' 


fmsg 


db 


cr,lf, 'BOOT.CMD Loaded into Common Memory$ ' 


f CO 


db 


04, 'BOOT ' , 'CMD', 0,0, 0,3, 0,0,0 ,0 ,0 ,0 ,0,0 




db 


0,0, 0,0 ,0,0,0 ,0 ,0 


pagel 


r s 


12S 




db 


0 




end 
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APPENDIX L 

PROGRAM LISTING OF B00T.A86 



;Prog Name 


B00T.A66 




JWritten by 


T.Almquist and 


D. Stevens 


;Date 


16 October 1982 


• 

f 


This program is the boot loader used by 


• 

> 


slave 86/12AS 


to load CP/M-86. 




3^ 3^'3}»3|C3(C 


5 


Equa tes 








load_addr equ 0400h 
cpm_addr equ 05001i 


• 




• 

> 


Main Program 






3;(3;;3;:3;:3;:3;:3;i3;c3;c 3 ;: 


cseg 






call 


request 


;get ticket number 


mo V 


' ai , 0O43h 


.’set es to C?/M segment # 


mo V 


es , ax 




mo V 


di , 3000h 


Jset desired offset 


mo V 


az , 3e300h 


.set ds to common memory 


mo V 


ds, ax 


; segment # 


mo V 


si , cpm_addr 


;CPM. SLAVE offset 


mo V 


cx , laO0h 


;number of bytes to move 


old 




; f rom common memory to 


rep mo\r5 


ax , ax 


.local memory 


call 


relea se 


; increment server # 


jmpf 


dword ptr bios 


_offset + load addr 






.’transfer to CP/M 


* ?;sa{5 5;c-c:;c5{c5;c3;K55:?;s3;c?Js>;c5jc?;c5;c5;s:;c)^5;s:j:::j:Xs:;c::<:;«?;:3j:5^:{J5;s5;s5;:5;s5?:j:5j«::cs?5{C5:s>jc;is5;s:;s5;s5;:;iS5;s:;s:;:5;c:;t5?^^^5;: 


• 

> 


I nc lude 


File 


• 5jS3jc a^s^csjcj^cslt^^cslcslcjicsjcsjc^^^jjsj^sslssjs^;;;:^ 3 ;?:^:;: 




include sync.aSe 


;for sharing common memory 


• 3jc5;c:;s5;c5^5;s5ic5;s :>:s;si;s:;s3jc3;c5jsi^j;:3;:?;cs}c5;r3^3’^5;?3j:3;s3;s5}c5;s 


«jy ww %<# %v uu «»# wu %V %v vV 

0^ 0^ 0^ # 1 % 0^ ^ 1 ^ 0^ 0^ 0^ 0^ 0^ 0^ #1% >1% 0^ ^ 1 % 0^ «|% ^ 1 % 0^% 0^ 0^ «py« ^ 1 ^ 


• 

> 


Data 




• 5{s5?>;<5;c;;c5;«3;i5;« ?;s3;c5;t5;53;{5j«5;«;i:j;;5;t5;s5|c5;c3;s5;:3;t5;:5ic;;c:;:3;: 


J;t5;«;;c5{cs;c?j:3;:5^j;c3;c5,‘e3j:3}:5;s3;c:<:s;c;j:;tc5jc;j;:;r>;s?tc3;i5jc3;«5;cjjc 


b i 0 s _ 0 f f s e t 


dw 2500h 


;C?/M .lump vector 


bios_seg 


dw 0040h 
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db 0 

end 
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APPENDIX M 

PROGRAM LISTING OP LOGIN. A86 



>*Prog Name 
>Da te 

jWritten by 



LOGIN. A86 

15 October 1982 

T. Almquist and D. Stevens 

This program contains the code necessary to 
permit only one user at a time to be log,?ed 
on to any I/O storage device. 



* SyC «}C ^ «|C ^ SgC iyC SyS 2yC Sfi ^ «|C «{« 3|S 3|C 3yS3yS 3^ 3^ 



Equates 



busy equ 0ffh 
ndsks equ 7 



Jbusy indicator 
; number of CP/M disks 



j 5*.c3»^3^3;c>^3;c3:;s;cs;c3lc3{s:;s3^:;s3ii;:53;s:;:3;t5;c3;c5j?3,’«::€3p5;:3{:3>;3jt3;c5;c5;s5?5{:s{c3;:5jc3;::{s:}:3;c3;s5;s:;<3js:;:5;<5;c5;<3X:;js;c5j:5;s5>:5:«3:53;s 



Subroutines 



• 3^:3;: 3|c 3;c 3te 3,*: :$c3i( 3^c 3y^: 3X ^ ^ ^ ^ ^ ^ ^ 3|:3;c3;:3^3i(3;t3;c3;(3;:3;c:;s3jc3is3;c3ic3;c3t;3:$:ic3^3;c3;e3;: 



login : 



cseg $ 



loge 



logl 



push 


es 


?set up to address corrmo 


mo V 


ax , cmemseg 


; memory 


mo V 


es , ax 




mo V 


bx, offset logmsg2 


Jget console number 


call 


pmsg 




call 


conin 


Jret console number in a 


cmp 


al ,31h 


;ensure response is betw 


jl 


1 Og0 


;i and 4 


cmp 


al , 34h 




Jg 


logo 




mo V 


consol e , al 


;save console number 


mo V 


bx, offset logmsgl 


; ini tal 1 ogi n msg 


call 


pmsg 


;print message 


call 


conin 


>get login disk 


cmp 


al,4lh 


Jwithin range defined by 


Jl 


logl 


jcpmmast.def 


cmp 


al , 40h + ndsks 


;greater than g: 


Jg 


logl 




and 


al ,0fh 


;strip upper nibble 


s ub 


al , 1 


;normalize to zero 


mo V 


user , al 


Jsave login user disk 
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Jdetermine if disk is free 



xor 


bx , bx 




mo V 


bl,al 


Jset up to index logtbl 


mov 


al ♦ busy 




lock 


xchg al , logtbl [bx] 




test 


al , al 


;is disk free? 


jz 


log2 


»*if so, enter console # 


cmp 


al , console 


Jis console already logged 


jnz 


restore 


;if not, restore logtbl 


log2; 


xo r 


bx , bx 


;dear bx 


mov 


bl , user 


Joffset in logtbl 


mov 


al .console 




lock 


xchg al , logtbl [bx] 


; enter console number 


jmp 


log_ret 




restore : 


lock 


xchg al .lofftbl [bx] 


;restore logtbl entry 


mov 


bx, offset logmsg3 


^request another disk g 


call 


pmsg 




jmp 


logl 




log_re t : 


pop 


es 




ret 



init_login: Jinitialize logtbl entries 



push 


es 


Jaddress common 


memor y 


mov 


ax , cmemse<e 






mov 


es, ax 






xor 


bXfhx 






xor 


cx ,cx 






mov 

• 


cl ,ndsks 


Jentry for each 


disk 


» • 

mo V 


1 o^tbl [ Dx] .0 


initialize ele 


ments of 


inc 


bx 


Jlogtbl to 0 




loop 


again 






pop 


es 






ret 









* ^ 5j(C «JC 9^ 3^ 5{C «JC 3fC Syt 3^ 3j« 3^ 5j£ 5j» 5^ 3jC 5ji 5j» 5j» 3JC 5^ Jjt 3jC 3^ 3jC 3|« 5^ 5JC 9^ 3}* 5|S 5^ 3jS 3|« 5|C 3}C 5^ SjC 3^ 3^ 3yS 3jS 3|C 3j« 3jt 5^ 

* Data Area 

* s;<5;s5;t>;«3;c5{:s;:3,‘c;;cs^5{cs;cs;c3}cs;s>;:5;s>;c3;c3^3^s3^ 3jt3*c5}:3is3j:jj:>^3;s3;:3^3tc3;:5;c5;:3;s5;c;;:3;c>.‘::;o^3;s3;t;;:3{c3;c3;s3;:3,‘:;;: 3;::;ci5c3?3;c3;s3jc 



user 


r b 


1 


console 


rb 


1 


logmsgl 


db 


cr ,lf , 'Enter 




db 


cr , If , 0 


logmsg2 


db 


cr ,lf , 'Enter 



Login DISK Letter (A,D,E,F,D)' 
Console Number (1,2, 3, 4)' 
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logmsgS 



logtbl 



;end login 



db cr ,lf , 0 

do cr, If, 'Disk in Use Reselect ' ,cr , If ,e 

eseg 
org 20b 

rb ndsks Jallot memory for logtbl 

cseg $ 

aS6 
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APPENDIX N 

PROGRAM LISTING 0F'STNC.A86 



Prog Name 
Da te 

Written by 
Modified by 
For 

Advisor 

Purpose 



:Synch .A86 
;7 October 1982 
:Niclc Hammond 

:T. Almquist and D. Stevens 
:Thesi s 

:Professor lodres 

:Provide synchronizations of CPM/86 read 
and write operations to the MBB-80 bubble 
memory board and the REMEX Data Warehouse. 



Synchronization Routine 

5jc >;c s;: 3}c ijc ajt >t£ :^c :«c 3^ :^c s;s 55c s;: 3;: s;c>;c s;c ijc 3;: :;c s;c>>: ^ ijc sjc :^c :{c>jc ^ ; j; 5jc j;c ;{c 5{c jj« s;c a|c 



:^3^:(K3;e3;:3jC3;C3;c:QC34:3;C3|£9;(:iC32C3iC3^3;C3;C3;C3iC3iC3;:3tC3jC:;S3;C3;:3;:3i;3}:3i(3;C3^3;;3;C3;?3;^3;C3^;;:a;C3;C3;:3;C3'^3;C3;;3;C3;C3:c3{C 3;cXC3;C3,‘t3;S3jC 

Equa tes 

'iS»i!*S^3l»Sl55|C3jC5i%5jC3jC3^3jS3iC3^3jC5j%3jC35J3{5^3jS3^3jS3jC3j£3jC3jCS52 5iS3^3iJ5jJ3!5C5jt3iC35S3jC5jS^3jC3{CStC5jC5iC55C3jJSlC5i?5li5|S5r3^1^^ 



cmemseg equ Oe000h Jsegment address of 

; comm on memory 

dcount equ 100 ;bus contention time delay 

; Suoroutines 

• 3iC3ie3;C3;C3g;:iC3)C3{C3)e3SC3iC3iC3^^3;C39C3;C3;:3^3;S3^:jC3;C3;C3;(3;e3;C3iC3;C3;:3^3;C3;C3te3X:te>;C<e^^«Sr^^^^^?r^:i?'r 

cseg $ 

ticket: Jreturn the next ticket number in 

;bx 



xor 


ax, ax 


;set reserved value 


lock 


ichg ax, next 


;get ticket number 


t est 


ax, ax 




jz 


ticket 


jrepeat if reserved 


mo V 


bx , ax 


;return next ticket 


inc 


ax 




jnz 


ticl 




inc 


ax 


JSicip reserved value 


mo V 


next , ax 


{increment ticjcet number 
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ret 



await: ;wait for server number to match 

;the customers ticlcet number passed 
Jin bi. To reduce bus contention, a 
Jdelay is used between periodic 
Jchecks of the server number 





cmp 


bx , server 


J if ticket = server 




Je 


a V a2 


Jcontinue process 




mov 


cx , dcount 


Jif not, insert delay 


awa 1 : 


dec 


cx 






jnz 


awa 1 








await 


J check server aeain 


awa2 : 


r et 







9 

ad vance : 




Jincrement server number to next 
Jvalue 


inc 


server 


J serve r=server-^l 


jnz 


advl 




inc 


server 


Jskip reserved value 


adv 1 : ret 







> 

request : 



Jget a ticket number and wait to oe 
; served 



push es 

mov ax,cmemseg 
mov es,ai 
call ticket 
call await 
pop es 
r et 



Jset es to address common 
Jmemory 

Jget ticket number 
Jwait to be served 



release: Jadv server number on completion 

J of read or write operation 

push es 

mov ax,cmemseg Jset es to address common 

mov es,ax Jmemory 

call advance Jinc server number 

pop es 

ret 



» 



in it sync : 



Jinitialize sequencer variables 



156 



push es 

mov ax.cmemseg 
mov es,ax 
mov ax,l 
mov server, ax 
mov next, ax 



pop es 
ret 



Jset es to address common 
Jmemo ry 

; server=next=l 



; Da ta 



eseg 



f only one 
; exist in 
;via es 



set of sequencer variables 
common memory; accessed 



server rw 1 
next rw 1 



cseg $ 
;end synch. aS6 
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